将字符串类型的日期和/或时间转换为日期/时间值。

说明

DateValue 函数可用于将日期字符串(例如“10/01/2014”)转换为日期/时间值。

TimeValue 函数可用于将时间字符串(例如“12:15 PM”)转换为日期/时间值。

DateTimeValue 函数可用于将日期和时间字符串(例如“January 10, 2013 12:13 AM”)转换为日期/时间值。

DateValue 函数会忽略日期字符串中的任何时间信息,而 TimeValue 函数则会忽略时间字符串中的任何日期信息。

默认情况下使用当前用户的语言环境,但你可以替代此设置以确保正确解释字符串。 例如,“10/1/1920”在“英语语言环境”中解释为 10 月 1 日,而在“法语语言环境”中则解释为 1 月 10 日。

日期必须采用以下格式之一︰

  • MM/DD/YYYY
  • DD/MM/YYYY
  • DD Mon YYYY
  • Month DD, YYYY

请参阅 DateTime 函数以从年、月、日、时、分、秒的数字部分进行转换。

有关详细信息,请参阅处理日期和时间

要转换数字,请参阅 Value 函数。

语法

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

  • String - 必需。 包含日期、时间或日期和时间值组合的文本字符串。
  • Language - 可选。 语言字符串,例如可通过 Language 函数返回语言的前两个字符。 如果未提供,则使用当前用户客户端的语言。

示例

DateValue

如果在“Startdate”文本输入控件中键入了“10/11/2014”,然后将标签的“Text”属性设置为以下函数:

  • Text(DateValue(Startdate.Text), DateTimeFormat.LongDate)

    如果你的计算机区域设置为 en,这个标签就会显示 Saturday, October 11, 2014

    注意:可以将几个选项与 DateTimeFormat 参数一起使用(LongDateTime 除外)。 要显示这些选项的列表,请在函数框中输入该参数,然后输入一个感叹号。

  • Text(DateValue(Startdate.Text, "fr"), DateTimeFormat.LongDate)

    这个标签会显示 Monday, November 10, 2014

如果对 October 20, 2014 执行上述操作:

  • DateDiff(DateValue(Startdate.Text), Today())

    如果你的计算机的语言设置为 en,这个标签会显示 9,表示 10 月 11 日到 10 月 20 日之间间隔的天数。 DateDiff 函数还可以显示月份、季度或年份之间的差值。

DateTimeValue

如果在“Start”文本输入控件中键入了“10/11/2014 1:50:24.765 PM”,然后将标签的“Text”属性设置为以下函数:

  • Text(DateTimeValue(Start.Text), DateTimeFormat.LongDateTime)

    如果你的计算机的区域设置为“en”,这个标签会显示 Saturday, October 11, 2014 1:50:24 PM

    注意:可以将几个选项与 DateTimeFormat 参数一起使用(LongDateTime 除外)。 要显示这些选项的列表,请在函数框中输入该参数,然后输入一个感叹号。

  • Text(DateTimeValue(Start.Text, "fr"), DateTimeFormat.LongDateTime)

    这个标签会显示 Monday, November 10, 2014 1:50:24 PM

  • Text(DateTimeValue(Start.Text), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM")

    如果你的计算机的区域设置为 en,这个标签会显示 Saturday, October 11, 2014 01:50:24:765 PM

    还有一种方法是指定 hh:mm:ss.fhh:mm:ss.ff 以将时间取整为秒的最接近 10 倍或 100 倍值。

TimeValue

将文本输入控件命名为“FinishedAt”,然后将标签的“Text”属性设置为以下函数:

If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")

  • 如果在 FinishedAt 控件中输入 4:59:59.999 PM,这个标签会显示“You made it!”

  • 如果在 FinishedAt 控件中键入 5:00:00.000 PM,这个标签会显示“Too late!”