FormatTime - (內建函數)
時間函數
語法:
把傳入的時間數值依照指定的格式組合轉成字串
字串 = FormatTime(格式字串組合, 時間數值)
說明:
時間數值是一個5~6碼的數字,格式是HHMMSS:
- HH是小時,數值範圍從0到23,可以是1位數字或是2位數字
- MM是分鐘,數值範圍從00到59,必須是2位數字
- SS是秒數,數值範圍從00到59,必須是2位數字
時間數值通常是透過CurrentTime,Time(資料的時間欄位),或是其他時間相關函數所產生的時間數值。
CurrentTimeMS,則是含有毫秒的時間數值,是一個 8~9 碼的數字,格式是HHMMSS.fff:
- HH是小時,數值範圍從0到23,可以是1位數字或是2位數字
- MM是分鐘,數值範圍從00到59,必須是2位數字
- SS是秒數,數值範圍從00到59,必須是2位數字
- fff是毫秒,數值範圍從000到999,必須是3位數字
格式字串可以是以下字串的組合:
- h: 回傳12小時制的小時,如果不到兩位數,前面不補零,例如上午8點的話回傳 "8",上午11點回傳 "11", 下午4點回傳 "4",
- hh: 回傳12小時制的小時,如果不到兩位數,前面補零,例如上午8點的話回傳 "08",上午11點回傳 "11", 下午4點回傳 "04",
- H: 回傳24小時制的小時,如果不到兩位數,前面不補零,例如上午8點的話回傳 "8",上午11點回傳 "11", 下午4點回傳 "16",
- HH: 回傳24小時制的小時,如果不到兩位數,前面補零,例如上午8點的話回傳 "08",上午11點回傳 "11", 下午4點回傳 "16",
- m: 回傳分鐘,如果不到兩位數,前面不補零,例如上午8點5的話回傳 "5",上午8點15分的話則回傳 "15",
- mm: 回傳分鐘,如果不到兩位數,前面補零,例如上午8點5的話回傳 "05",上午8點15分的話則回傳 "15",
- s: 回傳秒數,如果不到兩位數,前面不補零,例如上午8點5分5秒的話回傳 "5",上午8點5分15秒的話則回傳 "15",
- ss: 回傳秒數,如果不到兩位數,前面補零,例如上午8點5分5秒的話回傳 "05",上午8點5分15秒的話則回傳 "15",
- t: 回傳上午或是下午的代碼,例如時間是上午的話則回傳"A", 如果時間是下午的話則回傳"P",
- tt: 回傳上午或是下午的完整代碼,例如時間是上午的話則回傳"AM", 如果時間是下午的話則回傳"PM",
- fff: 回傳毫秒完整代碼,如果不到三位數,前面補零,例如上午8點5分5秒5毫秒的話回傳 "005",上午8點5分15秒555毫秒的話則回傳 "555",
格式字串內除了可以使用上面字串的組合之外,也可以搭配其他的字元。
範例如下
var:_Str1(""),_Str2("");
_Str1 = FormatTime("HH:mm:ss", 132530.255); // _Str1 = "13:25:30"
_Str2 = FormatTime("HH:mm:ss:fff", 132530.255); // _Str2 = "13:25:30"
注意到格式字串內有使用":"字串,這些額外的字串也會出現在回傳字串內。