API: datasource YAHOO.util.Date (YUI Library)

# Yahoo! UI Library

### DataSource Utility 2.9.0

Yahoo! UI Library > datasource > YAHOO.util.Date
Search:
Filters Show Private Show Protected Show Deprecated

## `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.