addtimeunit
這些函數透過將指定的時間單位數目新增至時間來傳回時間。
語法如下所示:
-
addseconds(time_value, time_units)
-
addminutes(time_value, time_units)
-
addhours(time_value, time_units)
-
adddays(time_value, time_units)
-
addmonths(time_value, time_units)
-
addyears(time_value, time_units)
- time_value
- time 類型的表示式。
- time_units
-
代表要新增至 time_value 之時間量的時間單位數目。例如,對於 addseconds 函數,此參數是要新增的秒數。如果要計算與 time_value 相對的逝去時間,請為此參數傳遞負數。
如果為此參數輸入浮點數值(例如,5.4 或 27.9),則僅使用該數值的整數部分。例如,5.4 會變成 5。
函數呼叫的下列範例會傳回一個時間,該時間是 entry_time 之後的指定小時數:
addhours (Entry_time, num_hours)
addmonths 和 addyears 的求值
addmonths 和 addyears 函數的演算法可能與各種開發環境中產生比較計算的方法不同。
對於 addmonths 函數,新增指定月數可以最初產生超出新月份的最後一天的日期。在此情況下,函數會傳回下一月的第一天。例如,下列表示式會傳回 03/01/1997:
addmonths (convert("01/31/1997 12:00:00", time), 1)
addyears 函數的求值是可比較的。例如,下列表示式傳回 03/01/2001:
您輸入的時間格式(在此情況下,是完整日期和時間)必須符合工作流程系統上的日期/時間遮罩。如需相關資訊,請參閱日期/時間遮罩。addyears (convert("02/29/2000 12:00:00", time), 1)