Yahoo! UI Library

DataSource Utility  2.9.0

Yahoo! UI Library > datasource > YAHOO.util.Date
Search:
 
Filters

static Class YAHOO.util.Date

The static Date class provides helper functions to deal with data of type Date.

Methods

format

HTML format ( oDate , oConfig , sLocale )
Takes a native JavaScript Date and formats to string for display to user.
Parameters:
oDate <Date> Date.
oConfig <Object> (Optional) Object literal of configuration values:
format <String>

Any strftime string is supported, such as "%I:%M:%S %p". strftime has several format specifiers defined by the Open group at http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html

PHP added a few of its own, defined at http://www.php.net/strftime

This javascript implementation supports all the PHP specifiers and a few more. The full list is below:

%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')
%F
same as %Y-%m-%d (ISO 8601 date format)
%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)
%k
hour as a decimal number using a 24-hour clock (range 0 to 23); single digits are preceded by a blank. (See also %H.)
%l
hour as a decimal number using a 12-hour clock (range 1 to 12); single digits are preceded by a blank. (See also %I.)
%m
month as a decimal number (range 01 to 12)
%M
minute as a decimal number
%n
newline character
%p
either `AM' or `PM' 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
number of seconds since the Epoch, ie, since 1970-01-01 00:00:00 UTC
%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
sLocale <String> (Optional) The locale to use when displaying days of week, months of the year, and other locale specific strings. The following locales are built in:
en
English
en-US
US English
en-GB
British English
en-AU
Australian English (identical to British English)
More locales may be added by subclassing of YAHOO.util.DateLocale. See YAHOO.util.DateLocale for more information.
Returns: HTML
Formatted date for display. Non-date values are passed through as-is.


Copyright © 2011 Yahoo! Inc. All rights reserved.