功能區塊 STR2DT
功能區塊 STR2DT 將以英文文字形式指定的任意日期轉換為新的日期。
輸入 IN
在輸入端，以 DT# 格式傳遞一個日期和時間。
輸入 STR
定義用於計算日期的字符串。
輸入端可以定義 1970 年之前的日期。 为此，需要传递一种格式，例如 "12/25/0000"。 這對應於第一個聖誕節。 其中第一個數字 12 是月份，第二個是 25 天。 年必須輸入四位數，否則只能假定為年份 2000 的值。
使用的符號
| 描述 | 格式 |
|---|---|
| 星期名稱 | 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' |
| 工作日 | 'weekday' | 'weekdays' |
| 數字 | [+-]?[0-9]+ |
| 序數 | 'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' | 'next' | 'last' | 'previous' | 'this' |
| 相對文本 | 'next' | 'last' | 'previous' | 'this' |
| 空格 | [ \t]+ |
| 單位 | (( 'sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' | 'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' | daytext |
基於日期的符號表示法
| 格式 | 描述 | 範例 |
|---|---|---|
| 'yesterday' | 昨天的午夜。 | "yesterday 14:00" |
| 'midnight' | 時間設定為 00:00:00 | |
| 'today' | 時間設定為 00:00:00 | |
| 'now' | 被忽略。 | |
| 'noon' | 時間設定為 12:00:00 | "yesterday noon" |
| 'tomorrow' | 明天的午夜。 | |
| 'back of' hour | 從特定時間開始 15 分鐘後。 | "back of 7pm", "back of 15" |
| 'front of' hour | 從特定時間開始 15 分鐘前。 | "front of 5am", "front of 23" |
| 'first day of' | 將日期設為當前月份的第一天。 這也適用於指定的月份和年份。 | "first day of January 2008" |
| 'last day of' | 將日期設為當前月份的最後一天。 這也適用於指定的月份和年份。 | "last day of next month" |
| ordinal space dayname space 'of' | 計算該月的第 x 天。 | "first sat of July 2008" |
| 'last' space dayname space 'of' | 計算該月的最後一天。 | "last sat of July 2008" |
| number space? (unit | 'week') | 計算相對於當前日期的偏移量。 | "+5 weeks", "12 day", "-7 weekdays" |
| ordinal space unit | 計算指定單位的相對時間。 | "fifth day", "second month" |
| 'ago' | 計算一個向後的時間點。 | "2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago" |
| dayname | 轉到下一個工作日。 | "Monday" |
| reltext space 'week' | 計算特殊格式 "weekday + last/this/next week"。 | "Monday next week" |
輸出 DT
返回以 DT# 格式表示的計算日期和時間。
輸出 ERR
在錯誤情況下，輸出為真。