DateTime.js 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454
  1. /* globals moment */
  2. /**
  3. * Date and time operations.
  4. *
  5. * @author n1474335 [n1474335@gmail.com]
  6. * @copyright Crown Copyright 2016
  7. * @license Apache-2.0
  8. *
  9. * @namespace
  10. */
  11. var DateTime = {
  12. /**
  13. * @constant
  14. * @default
  15. */
  16. UNITS: ["Seconds (s)", "Milliseconds (ms)", "Microseconds (μs)", "Nanoseconds (ns)"],
  17. /**
  18. * From UNIX Timestamp operation.
  19. *
  20. * @param {number} input
  21. * @param {Object[]} args
  22. * @returns {string}
  23. */
  24. runFromUnixTimestamp: function(input, args) {
  25. var units = args[0],
  26. d;
  27. input = parseFloat(input);
  28. if (units === "Seconds (s)") {
  29. d = moment.unix(input);
  30. return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss") + " UTC";
  31. } else if (units === "Milliseconds (ms)") {
  32. d = moment(input);
  33. return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
  34. } else if (units === "Microseconds (μs)") {
  35. d = moment(input / 1000);
  36. return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
  37. } else if (units === "Nanoseconds (ns)") {
  38. d = moment(input / 1000000);
  39. return d.tz("UTC").format("ddd D MMMM YYYY HH:mm:ss.SSS") + " UTC";
  40. } else {
  41. throw "Unrecognised unit";
  42. }
  43. },
  44. /**
  45. * To UNIX Timestamp operation.
  46. *
  47. * @param {string} input
  48. * @param {Object[]} args
  49. * @returns {number}
  50. */
  51. runToUnixTimestamp: function(input, args) {
  52. var units = args[0],
  53. d = moment(input);
  54. if (units === "Seconds (s)") {
  55. return d.unix();
  56. } else if (units === "Milliseconds (ms)") {
  57. return d.valueOf();
  58. } else if (units === "Microseconds (μs)") {
  59. return d.valueOf() * 1000;
  60. } else if (units === "Nanoseconds (ns)") {
  61. return d.valueOf() * 1000000;
  62. } else {
  63. throw "Unrecognised unit";
  64. }
  65. },
  66. /**
  67. * @constant
  68. * @default
  69. */
  70. DATETIME_FORMATS: [
  71. {
  72. name: "Standard date and time",
  73. value: "DD/MM/YYYY HH:mm:ss"
  74. },
  75. {
  76. name: "American-style date and time",
  77. value: "MM/DD/YYYY HH:mm:ss"
  78. },
  79. {
  80. name: "International date and time",
  81. value: "YYYY-MM-DD HH:mm:ss"
  82. },
  83. {
  84. name: "Verbose date and time",
  85. value: "dddd Do MMMM YYYY HH:mm:ss Z z"
  86. },
  87. {
  88. name: "UNIX timestamp (seconds)",
  89. value: "X"
  90. },
  91. {
  92. name: "UNIX timestamp offset (milliseconds)",
  93. value: "x"
  94. },
  95. {
  96. name: "Automatic",
  97. value: ""
  98. },
  99. ],
  100. /**
  101. * @constant
  102. * @default
  103. */
  104. INPUT_FORMAT_STRING: "DD/MM/YYYY HH:mm:ss",
  105. /**
  106. * @constant
  107. * @default
  108. */
  109. OUTPUT_FORMAT_STRING: "dddd Do MMMM YYYY HH:mm:ss Z z",
  110. /**
  111. * @constant
  112. * @default
  113. */
  114. TIMEZONES: ["UTC"].concat(moment.tz.names()),
  115. /**
  116. * Translate DateTime Format operation.
  117. *
  118. * @param {string} input
  119. * @param {Object[]} args
  120. * @returns {html}
  121. */
  122. runTranslateFormat: function(input, args) {
  123. var inputFormat = args[1],
  124. inputTimezone = args[2],
  125. outputFormat = args[3],
  126. outputTimezone = args[4],
  127. date;
  128. try {
  129. date = moment.tz(input, inputFormat, inputTimezone);
  130. if (!date || date.format() === "Invalid date") throw Error;
  131. } catch (err) {
  132. return "Invalid format.\n\n" + DateTime.FORMAT_EXAMPLES;
  133. }
  134. return date.tz(outputTimezone).format(outputFormat);
  135. },
  136. /**
  137. * Parse DateTime operation.
  138. *
  139. * @param {string} input
  140. * @param {Object[]} args
  141. * @returns {html}
  142. */
  143. runParse: function(input, args) {
  144. var inputFormat = args[1],
  145. inputTimezone = args[2],
  146. date,
  147. output = "";
  148. try {
  149. date = moment.tz(input, inputFormat, inputTimezone);
  150. if (!date || date.format() === "Invalid date") throw Error;
  151. } catch (err) {
  152. return "Invalid format.\n\n" + DateTime.FORMAT_EXAMPLES;
  153. }
  154. output += "Date: " + date.format("dddd Do MMMM YYYY") +
  155. "\nTime: " + date.format("HH:mm:ss") +
  156. "\nPeriod: " + date.format("A") +
  157. "\nTimezone: " + date.format("z") +
  158. "\nUTC offset: " + date.format("ZZ") +
  159. "\n\nDaylight Saving Time: " + date.isDST() +
  160. "\nLeap year: " + date.isLeapYear() +
  161. "\nDays in this month: " + date.daysInMonth() +
  162. "\n\nDay of year: " + date.dayOfYear() +
  163. "\nWeek number: " + date.weekYear() +
  164. "\nQuarter: " + date.quarter();
  165. return output;
  166. },
  167. /**
  168. * @constant
  169. */
  170. FORMAT_EXAMPLES: "Format string tokens:\n\n\
  171. <table class='table table-striped table-hover table-condensed table-bordered' style='font-family: sans-serif'>\
  172. <thead>\
  173. <tr>\
  174. <th>Category</th>\
  175. <th>Token</th>\
  176. <th>Output</th>\
  177. </tr>\
  178. </thead>\
  179. <tbody>\
  180. <tr>\
  181. <td><b>Month</b></td>\
  182. <td>M</td>\
  183. <td>1 2 ... 11 12</td>\
  184. </tr>\
  185. <tr>\
  186. <td></td>\
  187. <td>Mo</td>\
  188. <td>1st 2nd ... 11th 12th</td>\
  189. </tr>\
  190. <tr>\
  191. <td></td>\
  192. <td>MM</td>\
  193. <td>01 02 ... 11 12</td>\
  194. </tr>\
  195. <tr>\
  196. <td></td>\
  197. <td>MMM</td>\
  198. <td>Jan Feb ... Nov Dec</td>\
  199. </tr>\
  200. <tr>\
  201. <td></td>\
  202. <td>MMMM</td>\
  203. <td>January February ... November December</td>\
  204. </tr>\
  205. <tr>\
  206. <td><b>Quarter</b></td>\
  207. <td>Q</td>\
  208. <td>1 2 3 4</td>\
  209. </tr>\
  210. <tr>\
  211. <td><b>Day of Month</b></td>\
  212. <td>D</td>\
  213. <td>1 2 ... 30 31</td>\
  214. </tr>\
  215. <tr>\
  216. <td></td>\
  217. <td>Do</td>\
  218. <td>1st 2nd ... 30th 31st</td>\
  219. </tr>\
  220. <tr>\
  221. <td></td>\
  222. <td>DD</td>\
  223. <td>01 02 ... 30 31</td>\
  224. </tr>\
  225. <tr>\
  226. <td><b>Day of Year</b></td>\
  227. <td>DDD</td>\
  228. <td>1 2 ... 364 365</td>\
  229. </tr>\
  230. <tr>\
  231. <td></td>\
  232. <td>DDDo</td>\
  233. <td>1st 2nd ... 364th 365th</td>\
  234. </tr>\
  235. <tr>\
  236. <td></td>\
  237. <td>DDDD</td>\
  238. <td>001 002 ... 364 365</td>\
  239. </tr>\
  240. <tr>\
  241. <td><b>Day of Week</b></td>\
  242. <td>d</td>\
  243. <td>0 1 ... 5 6</td>\
  244. </tr>\
  245. <tr>\
  246. <td></td>\
  247. <td>do</td>\
  248. <td>0th 1st ... 5th 6th</td>\
  249. </tr>\
  250. <tr>\
  251. <td></td>\
  252. <td>dd</td>\
  253. <td>Su Mo ... Fr Sa</td>\
  254. </tr>\
  255. <tr>\
  256. <td></td>\
  257. <td>ddd</td>\
  258. <td>Sun Mon ... Fri Sat</td>\
  259. </tr>\
  260. <tr>\
  261. <td></td>\
  262. <td>dddd</td>\
  263. <td>Sunday Monday ... Friday Saturday</td>\
  264. </tr>\
  265. <tr>\
  266. <td><b>Day of Week (Locale)</b></td>\
  267. <td>e</td>\
  268. <td>0 1 ... 5 6</td>\
  269. </tr>\
  270. <tr>\
  271. <td><b>Day of Week (ISO)</b></td>\
  272. <td>E</td>\
  273. <td>1 2 ... 6 7</td>\
  274. </tr>\
  275. <tr>\
  276. <td><b>Week of Year</b></td>\
  277. <td>w</td>\
  278. <td>1 2 ... 52 53</td>\
  279. </tr>\
  280. <tr>\
  281. <td></td>\
  282. <td>wo</td>\
  283. <td>1st 2nd ... 52nd 53rd</td>\
  284. </tr>\
  285. <tr>\
  286. <td></td>\
  287. <td>ww</td>\
  288. <td>01 02 ... 52 53</td>\
  289. </tr>\
  290. <tr>\
  291. <td><b>Week of Year (ISO)</b></td>\
  292. <td>W</td>\
  293. <td>1 2 ... 52 53</td>\
  294. </tr>\
  295. <tr>\
  296. <td></td>\
  297. <td>Wo</td>\
  298. <td>1st 2nd ... 52nd 53rd</td>\
  299. </tr>\
  300. <tr>\
  301. <td></td>\
  302. <td>WW</td>\
  303. <td>01 02 ... 52 53</td>\
  304. </tr>\
  305. <tr>\
  306. <td><b>Year</b></td>\
  307. <td>YY</td>\
  308. <td>70 71 ... 29 30</td>\
  309. </tr>\
  310. <tr>\
  311. <td></td>\
  312. <td>YYYY</td>\
  313. <td>1970 1971 ... 2029 2030</td>\
  314. </tr>\
  315. <tr>\
  316. <td><b>Week Year</b></td>\
  317. <td>gg</td>\
  318. <td>70 71 ... 29 30</td>\
  319. </tr>\
  320. <tr>\
  321. <td></td>\
  322. <td>gggg</td>\
  323. <td>1970 1971 ... 2029 2030</td>\
  324. </tr>\
  325. <tr>\
  326. <td><b>Week Year (ISO)</b></td>\
  327. <td>GG</td>\
  328. <td>70 71 ... 29 30</td>\
  329. </tr>\
  330. <tr>\
  331. <td></td>\
  332. <td>GGGG</td>\
  333. <td>1970 1971 ... 2029 2030</td>\
  334. </tr>\
  335. <tr>\
  336. <td><b>AM/PM</b></td>\
  337. <td>A</td>\
  338. <td>AM PM</td>\
  339. </tr>\
  340. <tr>\
  341. <td></td>\
  342. <td>a</td>\
  343. <td>am pm</td>\
  344. </tr>\
  345. <tr>\
  346. <td><b>Hour</b></td>\
  347. <td>H</td>\
  348. <td>0 1 ... 22 23</td>\
  349. </tr>\
  350. <tr>\
  351. <td></td>\
  352. <td>HH</td>\
  353. <td>00 01 ... 22 23</td>\
  354. </tr>\
  355. <tr>\
  356. <td></td>\
  357. <td>h</td>\
  358. <td>1 2 ... 11 12</td>\
  359. </tr>\
  360. <tr>\
  361. <td></td>\
  362. <td>hh</td>\
  363. <td>01 02 ... 11 12</td>\
  364. </tr>\
  365. <tr>\
  366. <td><b>Minute</b></td>\
  367. <td>m</td>\
  368. <td>0 1 ... 58 59</td>\
  369. </tr>\
  370. <tr>\
  371. <td></td>\
  372. <td>mm</td>\
  373. <td>00 01 ... 58 59</td>\
  374. </tr>\
  375. <tr>\
  376. <td><b>Second</b></td>\
  377. <td>s</td>\
  378. <td>0 1 ... 58 59</td>\
  379. </tr>\
  380. <tr>\
  381. <td></td>\
  382. <td>ss</td>\
  383. <td>00 01 ... 58 59</td>\
  384. </tr>\
  385. <tr>\
  386. <td><b>Fractional Second</b></td>\
  387. <td>S</td>\
  388. <td>0 1 ... 8 9</td>\
  389. </tr>\
  390. <tr>\
  391. <td></td>\
  392. <td>SS</td>\
  393. <td>00 01 ... 98 99</td>\
  394. </tr>\
  395. <tr>\
  396. <td></td>\
  397. <td>SSS</td>\
  398. <td>000 001 ... 998 999</td>\
  399. </tr>\
  400. <tr>\
  401. <td></td>\
  402. <td>SSSS ... SSSSSSSSS</td>\
  403. <td>000[0..] 001[0..] ... 998[0..] 999[0..]</td>\
  404. </tr>\
  405. <tr>\
  406. <td><b>Timezone</b></td>\
  407. <td>z or zz</td>\
  408. <td>EST CST ... MST PST</td>\
  409. </tr>\
  410. <tr>\
  411. <td></td>\
  412. <td>Z</td>\
  413. <td>-07:00 -06:00 ... +06:00 +07:00</td>\
  414. </tr>\
  415. <tr>\
  416. <td></td>\
  417. <td>ZZ</td>\
  418. <td>-0700 -0600 ... +0600 +0700</td>\
  419. </tr>\
  420. <tr>\
  421. <td><b>Unix Timestamp</b></td>\
  422. <td>X</td>\
  423. <td>1360013296</td>\
  424. </tr>\
  425. <tr>\
  426. <td><b>Unix Millisecond Timestamp</b></td>\
  427. <td>x</td>\
  428. <td>1360013296123</td>\
  429. </tr>\
  430. </tbody>\
  431. </table>",
  432. };