IBM FileNet P8, 5.2.1 版            

日期/時間遮罩

日期/時間遮罩可以提供下列兩個用途之一:決定各種函數的輸出格式,或引導從值的字串表示法轉換成該值的內部形式。

以下是日期/時間遮罩的兩個用途:

  • 它決定各種函數的輸出格式。例如,在 timetostring 函數中,日期/時間遮罩指出用於字串輸出的格式。 如果日期/時間遮罩是 "hh:tt:ss",且時間值等於 9:12 a.m. 過 24 秒,則字串輸出為 09:12:24。
  • 它引導從值的字串表示法轉換成該值的內部形式。 例如,在 stringtotime 函數中,日期/時間遮罩指出輸入字串的格式,使它能夠正確轉換成時間值。 如果輸入字串是 "05/06/1995",則日期/時間遮罩 "mm/dd/yyyy" 指出子字串 "05" 代表月而不是日。

日期/時間遮罩是字串表示式,包含任何有效的元件組合及選用的分隔字元。 因為日期/時間遮罩是字串,所以您必須用雙引號括住它。

如需使用範例,請參閱日期/時間遮罩的相關資訊。

元件

以下是日期/時間遮罩可接受的元件。 在適當之處會列出每一個元件的有效範圍。

表 1. 日期/時間遮罩元件的表格
元件 意義
dd 月的兩位數日期 (1-31)。
ddd 年的三位數日期 (1-366)。
mm 一位數或二位數的月 (1-12)。
mon 月的三字母縮寫 (Jan-Dec)。
month 月的完整名稱 (January-December)。
yy 二位數的年 (00-99)。

我們強烈建議使用四位數元件 (yyyy) 而非二位數元件。 使用二位數元件時,內部會假設前兩位數是 "20",這可能不是您想要的。 此外,使用四位數元件可明確識別世紀,而避免語義不明確的問題。

yyyy 四位數的年 (0000-9999)。
w 一位數的星期幾 (0-6、0 = Sunday、6 = Saturday)。
day 星期幾的三字母縮寫 (Sat-Sun)。
dayname 星期幾的完整名稱 (Sunday-Saturday)。
hh 日的小時 (0-23)。
tt 小時的分鐘 (0-59)。
ss 分鐘的秒 (0-59)。
am 指出時間是 am 或 pm(對照 24 小時制)。
xs:datetime

指出 XML 格式的日期和時間,如 W3C XML 綱目和 ISO 8601 所述。格式為:

CCYY-MM-DDThh:mm:ss

所有欄位必須出現,且之前可選擇性地加上符號和前導數字(必要的話),其後跟著秒的小數位數和時區。 可使用字母 "Z"(其識別 UTC)指定時區,或透過與 UTC 的時差來表示。

分隔字元

下列符號是有效的分隔字元。 使用分隔字元是選用的。

表 2. 有效分隔字元符號的表格
分隔字元符號 分隔字元符號 分隔字元符號
, . /
- < >
? : |
^ ; "
[ ] {
} _ =
@ % +
( ) *
& # <space>

範例

在所有範例中,時間等於:
  • Wednesday, June 8, 2000 at 32 seconds after 2:05 p.m.
表 3. 範例日期/時間遮罩及結果的表格
遮罩 結果
"mon. dd, yyyy"
Jun. 8, 2000
"month dd, yyyy"
June 8, 2000
"mon dd, yy (day)"
Jun 8, 00 (Wed)
''hhttss"
140532
"hh:tt am"
02:05 pm
"dd-mm-yy, hh:tt"
8-6-00, 14:05
"mm/dd/yyyy, hh:tt:ss am"
6/8/2000, 02:05:032 pm
"ddd, hh:tt:ss"
167, 14:05:32
"tt:ss am"
05:32 pm
"xs:datetime"
2000-06-08T14:05:32


前次更新: 2016 年 3 月
bpfe019.htm

© Copyright IBM Corp. 2016.