將日期、時間或兩者的字串轉換成日期/時間值。

說明

DateValue 函式會將日期字串 (例如,"10/01/2014") 轉換成日期/時間值。

TimeValue 函式會將時間字串 (例如,"12:15 PM") 轉換成日期/時間值。

DateTimeValue 函式會將日期和時間字串 (例如,"January 10, 2013 12:13 AM") 轉換成日期/時間值。

DateValue 函式會忽略日期字串中的任何時間資訊,而 TimeValue 函式會忽略時間字串中的任何日期資訊。

根據預設,所使用的是目前使用者的語言,但您可以覆寫此選項以確保會正確解譯字串。 例如,"10/1/1920" 在 "en" 中會解譯為年 10 月 1 日,而在 "fr" 中為 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

如果您將 10/11/2014 輸入至名為 Startdate 的文字輸入控制項,然後將標籤的 Text 屬性設定為下列函式︰

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

    如果您的電腦設定為 en 地區設定,則標籤會顯示 2014 年 10 月 11 日星期六

    注意︰您可以使用數個選項,有別於 LongDateTime,與 DateTimeFormat 參數。 若要顯示這些選項的清單,請在函式方塊中輸入參數,後面緊接著一個驚嘆號。

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

    標籤會顯示 2014 年 11 月 10 日星期一

如果您在 2014 年 10 月 20 日執行相同動作:

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

    如果您的電腦設定為 en 語言,標籤會顯示 9,表示 10 月 11 日和 10 月 20 之間的天數。 DateDiff 函式也可以顯示月、季或年中的差異。

DateTimeValue

如果您將 10/11/2014 1:50:24.765 PM 輸入至名為 Start 的文字輸入控制項,然後將標籤的 Text 屬性設定為下列函式︰

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

    如果您的電腦設定為 "en" 地區設定,則標籤會顯示 2014 年 10 月 11 日星期六下午 1:50:24

    注意︰您可以使用數個選項,有別於 LongDateTime,與 DateTimeFormat 參數。 若要顯示這些選項的清單,請在函式方塊中輸入參數,後面緊接著一個驚嘆號。

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

    標籤會顯示 2014 年 11 月 10 日星期一下午 1:50:24

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

    如果您的電腦設定為 en 地區設定,則標籤會顯示 2014 年 10 月 11 日星期六下午 01:50:24:765

    或者,若要將時間四捨五入至最接近的十分之一或百分之一秒,請指定 hh:mm:ss.fhh:mm:ss.ff

TimeValue

將文字輸入控制項命名為 FinishedAt,並將標籤的 Text 屬性設定為下列函式︰

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

  • 如果您輸入 4:59:59.999 PMFinishedAt 控制項,標籤會顯示「您成功了!」

  • 如果您輸入 5:00:00.000 PMFinishedAt 控制項,標籤會顯示「您成功了!」