在日期/時間值新增或尋找差異，並且在當地時間與 UTC 之間轉換。

說明

DateAdd 函式會將單位數新增至日期/時間值。 結果是新的日期/時間值。 您也可以藉由指定負數值以從日期/時間值減去單位數。

DateDiff 函式會傳回兩個日期/時間值之間的差異。 結果是單位數。

對於這兩個函式，單位可以是毫秒、秒、分鐘、小時、天、月、季或年。 根據預設，這兩個函式會使用天作為單位。

TimeZoneOffset 函式會傳回使用者當地時間與 UTC (國際標準時間) 之間的分鐘數。

您可以搭配使用 DateAdd 與 TimeZoneOffset，在使用者的當地時間與 UTC (國際標準時間) 之間進行轉換。 新增 TimeZoneOffset 會將當地時間轉換為 UTC，而減去 (新增負數) 會從 UTC 轉換為當地時間。

另請參閱處理日期和時間以取得詳細資訊。

語法

DateAdd( DateTime, Addition [, Units ] )

  • DateTime - 必要項目。 要運作的日期/時間值。
  • Addition - 必要項目。 要在 DateTime 中新增的數目，以 Units 為單位。
  • Units - 選擇性項目。 要新增的 Units 類型：毫秒、秒、分鐘、小時、天、月、季或年。 如果未指定，系統會使用天。

DateDiff( StartDateTime, EndDateTime [, Units ] )

  • StartDateTime - 必要項目。 開始日期/時間值。
  • EndDateTime - 必要項目。 結束日期/時間值。
  • Units - 選擇性項目。 要新增的 Units 類型：毫秒、秒、分鐘、小時、天、月、季或年。 如果未指定，系統會使用天。

TimeZoneOffset( [ DateTime ] )

  • DateTime - 選擇性。 要傳回其時差的日期/時間值。 根據預設，會使用目前的日期/時間。

範例

在所有範例中，假設目前的日期與時間是2013 年 7 月 15 日，下午 1:02。

簡單 DateAdd

公式 說明 結果
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )		 將三天 (預設單位) 新增至目前的日期與時間。 "18-07-2013 13:02"
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )		 將四個小時新增至目前的日期與時間。 "15-07-2013 17:02"
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )		 將一個月新增至目前的日期，不含時間作為今天，不會傳回時間元件。 "15-08-2013 00:00"
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )		 從目前的日期與時間減去 30 分鐘。 "15-07-2013 12:32"

簡單 DateDiff

公式 說明 結果
DateDiff( Now(), DateValue("1/1/2014") ) 以預設單位天傳回兩個單位之間的差異 170
DateDiff( Now(), DateValue("1/1/2014"), Months ) 以月傳回兩個值之間的差異 6
DateDiff( Now(), Today(), Minutes ) 傳回目前的日期/時間與目前日期 (不含時間) 之間的差異，以分鐘為單位。 因為現在晚於今天，所以結果會是負數。 -782

轉換成 UTC

若要轉換成 UTC (國際標準時間)，針對指定的時間新增 TimeZoneOffset。

例如，假設目前的日期與時間是太平洋日光節約時間 (PDT UTC-7) 2013 年 7 月 15 日，下午 1:02。 若要判斷目前的 UTC 時間，請使用：

  • DateAdd( Now(), TimeZoneOffset(), Minutes )

TimeZoneOffset 預設為目前的時間，因此您不需要傳遞引數給它。

若要查看結果，請使用 Text 函式與格式 *dd-mm-yyyy hh:mm*，這會傳回 15-07-2013 20:02。

從 UTC 轉換

若要從 UTC 轉換，針對指定的時間減去 TimeZoneOffset (新增負數)。

例如，假設 UTC 日期與時間 2013 年 7 月 15 日，下午 8:02 是儲存在名為 StartTime 的變數。 若要調整使用者時區的時間，請使用：

  • DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )

請注意，TimeZoneOffset 前面的負號會減去時差，而不是新增它。

若要查看結果，請使用 Text 函式與格式 *dd-mm-yyyy hh:mm*，如果您位於太平洋日光節約時間的時區，這會傳回 15-07-2013 13:02。