TiddlyWiki5/editions/tw5.com/tiddlers/macros/NowMacro.tid

caption: now
created: 20141008141616791
modified: 20170630223406157
tags: Macros [[Core Macros]]
title: now Macro
type: text/vnd.tiddlywiki

The <<.def now>> [[macro|Macros]] returns the current date and time in a specified [[format|DateFormat]].

The value doesn't update automatically, like a ticking clock. It updates whenever the macro call is rendered, such as when the containing tiddler's display needs to be refreshed for some other reason.

!! Parameters

;format
: A string specifying the desired [[format|DateFormat]], defaulting to `0hh:0mm, DDth MMM YYYY`

''Note'': The format string `[UTC]YYYY0MM0DD0hh0mm0ssXXX` will return a date string representing the UTC time-stamp as it is used in the ~TiddlyWiki `created` and `modified` time-stamp fields.


<<.macro-examples "now">>
Fix caption field of NowMacro doc tiddler 2014-10-13 16:08:28 +00:00			`caption: now`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00			`created: 20141008141616791`
Add ability to now macro to return same UTC string used in date fields (#2884) * Add ability to now macro to return same UTC string used in the modified and created fields. * Revert "Add ability to now macro to return same UTC string used in the modified and created fields." This reverts commit 7b6ad7db4ae3058d5cf0d8858cdb24d44224ef69. * Mods to formatDateString to adjust displayed date to UTC for [UTC] format. Corresponding doc changes, and optimization for special case. 2017-07-01 17:09:16 +00:00			`modified: 20170630223406157`
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`tags: Macros [[Core Macros]]`
			`title: now Macro`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00			`type: text/vnd.tiddlywiki`

Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`The <<.def now>> [[macro\|Macros]] returns the current date and time in a specified [[format\|DateFormat]].`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`The value doesn't update automatically, like a ticking clock. It updates whenever the macro call is rendered, such as when the containing tiddler's display needs to be refreshed for some other reason.`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`!! Parameters`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00
Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`;format`
			: A string specifying the desired [[format\|DateFormat]], defaulting to `0hh:0mm, DDth MMM YYYY`
Add a new journal page toolbar button Spot the easter egg with the toolbar button… Fixes #336 2014-10-08 16:46:34 +00:00
Add ability to now macro to return same UTC string used in date fields (#2884) * Add ability to now macro to return same UTC string used in the modified and created fields. * Revert "Add ability to now macro to return same UTC string used in the modified and created fields." This reverts commit 7b6ad7db4ae3058d5cf0d8858cdb24d44224ef69. * Mods to formatDateString to adjust displayed date to UTC for [UTC] format. Corresponding doc changes, and optimization for special case. 2017-07-01 17:09:16 +00:00			''Note'': The format string `[UTC]YYYY0MM0DD0hh0mm0ssXXX` will return a date string representing the UTC time-stamp as it is used in the ~TiddlyWiki `created` and `modified` time-stamp fields.


Overhaul the macro and variable documentation #1519 2015-02-24 16:41:16 +00:00			`<<.macro-examples "now">>`