mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-28 11:00:27 +00:00
ba2c9f44b0
* Add description of field date format * Add description of field date format and improvements Due to the re-creation of the PR all changes to this file got mushed together.
32 lines
1.2 KiB
Plaintext
32 lines
1.2 KiB
Plaintext
created: 20150117190213631
|
|
modified: 20230226144641763
|
|
tags: Concepts
|
|
title: Date Fields
|
|
type: text/vnd.tiddlywiki
|
|
|
|
Certain [[fields|TiddlerFields]] of a tiddler are used to store dates and times. TiddlyWiki supports dates from the year -9999 to the year 9999.
|
|
|
|
The two standard date fields are <<.field created>> and <<.field modified>>.
|
|
|
|
Values of date fields are 17 or 18-character strings:
|
|
|
|
* <<.from-version "5.1.23">> an optional minus sign `-` to indicate a negative year
|
|
* 4 digits for the year
|
|
* 2 digits for the month
|
|
* 2 digits for the day
|
|
* 2 digits for the hour
|
|
* 2 digits for the minute
|
|
* 2 digits for the second
|
|
* 3 digits for the millisecond
|
|
|
|
To avoid problems arising from differences of time zone, TiddlyWiki always uses [[UTC|https://en.wikipedia.org/wiki/Coordinated_Universal_Time]].
|
|
|
|
The [[DateFormat]] template for storage of dates in these fields is `[UTC]YYYY0MM0DD0hh0mm0ss0XXX`.
|
|
|
|
As an example, the <<.field created>> field of this tiddler has the value <<.value """<$view field="created"/>""">>.
|
|
|
|
Dates can be [[converted to other formats|DateFormat]] for display:
|
|
|
|
<$macrocall $name="wikitext-example-without-html"
|
|
src="""<$view field="created" format="date" template="DDD DDth MMM YYYY"/>""">
|