Module: UWA/Date

UWA/Date

Date function utilities

Index

Methods

Methods

<static> UWA.Date.strftime(date, fmt) → {String}

Javascript implementation of strftime.

Implements strftime for the Date object in javascript based on the PHP implementation described at http://www.php.net/strftime This is in turn based on the Open Group specification defined at http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html This implementation does not include modified conversion specifiers (i.e., Ex and Ox).

Example
// Simple Example
var d = new Date();
var ymd = UWA.Date.strftime(d, '%Y/%m/%d');
var iso = UWA.Date.strftime(d, '%Y-%m-%dT%H:%M:%S%z');

// To get the current time in hours and minutes:
var d = new Date();
UWA.Date.strftime(d, "%H:%M");

// To get the current time with seconds in AM/PM notation:
var d = new Date();
UWA.Date.strftime(d, "%r");

// To get the year and day of the year for August 23, 2009:
var d = new Date('2009/8/23');
UWA.Date.strftime(d, "%Y-%j");
Parameters
Name Type Description
date Date

the date to format
fmt String

The format to format the date in, this may be a combination of the supported format specifiers

List of supported format specifiers:

  • %a - abbreviated weekday name according to the current locale
  • %A - full weekday name according to the current locale
  • %b - abbreviated month name according to the current locale
  • %B - full month name according to the current locale
  • %c - preferred date and time representation for the current locale
  • %C - century number (the year divided by 100 and truncated to an integer, range 00 to 99)
  • %d - day of the month as a decimal number (range 01 to 31)
  • %D - same as m/d/y
  • %e - day of the month as a decimal number, a single digit is preceded by a space (range ' 1' to '31')
  • %g - like G, but without the century
  • %G - The 4-digit year corresponding to the ISO week number
  • %h - same as b
  • %H - hour as a decimal number using a 24-hour clock (range 00 to 23)
  • %I - hour as a decimal number using a 12-hour clock (range 01 to 12)
  • %j - day of the year as a decimal number (range 001 to 366)
  • %m - month as a decimal number (range 01 to 12)
  • %M - minute as a decimal number
  • %n - newline character
  • %p - either AM' orPM' according to the given time value, or the corresponding strings for the current locale
  • %P - like p, but lower case
  • %r - time in a.m. and p.m. notation equal to I:M:S p
  • %R - time in 24 hour notation equal to H:M
  • %S - second as a decimal number
  • %t - tab character
  • %T - current time, equal to H:M:S
  • %u - weekday as a decimal number [1,7], with 1 representing Monday
  • %U - week number of the current year as a decimal number, starting with the first Sunday as the first day of the first week
  • %V - The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week.
  • %w - day of the week as a decimal, Sunday being 0
  • %W - week number of the current year as a decimal number, starting with the first Monday as the first day of the first week
  • %x - preferred date representation for the current locale without the time
  • %X - preferred time representation for the current locale without the date
  • %y - year as a decimal number without a century (range 00 to 99)
  • %Y - year as a decimal number including the century
  • %z - numerical time zone representation
  • %Z - time zone name or abbreviation
  • % - a literal `%' character
Returns

A string representation of the date formatted based on the passed in parameter.

Type
String
See: