Newest functions Upload a function Leave a tip My account

There are 2,522 functions in this library.

wc3DateCode ( wc3Date ; wc3Time )

Returns WC3 date code

  Average rating: 4.5 (32 votes) Log in to vote

Roger Biel 2Geckos Consulting, LLC www.2geckos.com

  Function definition: (Copy & paste into FileMaker's Edit Custom Function window)

// wc3DateCode( wc3Date ; wc3Time ) /* YYYYMMDDThhmmss.sTZD (eg 20120410T122800Z) YYYY = four-digit year MM = two-digit month (01=January, etc.) DD = two-digit day of month (01 through 31) hh = two digits of hour (00 through 23) (am/pm NOT allowed) mm = two digits of minute (00 through 59) ss = two digits of second (00 through 59) s = one or more digits representing a decimal fraction of a second TZD = time zone designator (Z or +hh:mm or -hh:mm) */ Let( [ wc3Date = If( IsEmpty( wc3Date ) ;Get( CurrentTimeStamp ) ; wc3Date ) ; wc3Time = If( IsEmpty( wc3Time ) ;Get( CurrentTimeStamp ) ; wc3Time ) ] ; Year ( wc3Date ) & If( Month ( wc3Date ) < 10 ; "0" ; "" ) & Month ( wc3Date ) & If ( Day ( wc3Date ) < 10 ; "0" ; "" ) & Day ( wc3Date ) & "T" & If (Hour ( wc3Time ) < 10 ; 0 & Hour ( wc3Time ) ; Hour ( wc3Time )) & If ( Minute ( wc3Time ) < 10 ; 0 & Minute ( wc3Time ) ; Minute ( wc3Time )) & "00Z" ) Click to copy

The International Standard for the representation of dates and times is ISO 8601. Its full reference number is ISO 8601 : 1988 (E), and its title is "Data elements and interchange formats - Information interchange - Representation of dates and times". A discussion of ISO 8601 has been written by Markus Kuhn.

YYYY = four-digit year
MM = two-digit month (01=January, etc.)
DD = two-digit day of month (01 through 31)
hh = two digits of hour (00 through 23) (am/pm NOT allowed)
mm = two digits of minute (00 through 59)
ss = two digits of second (00 through 59)
s = one or more digits representing a decimal fraction of a second
TZD = time zone designator (Z or +hh:mm or -hh:mm)

I had used the format YYYY-MM-DDThh:mm:ss.sTZD
but have found that the format YYYYMMDDThhmmss.sTZD
is used more often with no separators.

This profile does not specify how many digits may be used to represent the decimal fraction of a second. An adopting standard that permits fractions of a second must specify both the minimum number of digits (a number greater than or equal to one) and the maximum number of digits (the maximum may be stated to be "unlimited").

The formats are as follows. Exactly the components shown here must be present, with exactly this punctuation. Note that the "T" appears literally in the string, to indicate the beginning of the time element, as specified in ISO 8601.

This profile defines two ways of handling time zone offsets:

Times are expressed in UTC (Coordinated Universal Time), with a special UTC designator ("Z").
Times are expressed in local time, together with a time zone offset in hours and minutes. A time zone offset of "+hh:mm" indicates that the date/time uses a local time zone which is "hh" hours and "mm" minutes ahead of UTC. A time zone offset of "-hh:mm" indicates that the date/time uses a local time zone which is "hh" hours and "mm" minutes behind UTC.
A standard referencing this profile should permit one or both of these ways of handling time zone offsets.

Source: http://www.w3.org/TR/NOTE-datetime

 

Comments

Log in to post comments.

 

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

Support this website.

This library has been a free commmunity resource for FileMaker users and developers for 20 years. It receives no funding and has no advertisements. If it has helped you out, I'd really appreciate it if you could contribute whatever you think it's worth: