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"

注意到格式字串內有使用":"字串,這些額外的字串也會出現在回傳字串內。