# $date

Returns a date/time string using a specified format

Usage

    $date(<format>[,<unixtime>])

Description

Returns the string representation of <unixtime> or of the current time if <unixtime> is not given, based on <format>.
The <format string> should contain a set of characters that will be transformed according to the following rules:

a | The abbreviated weekday name according to the current locale.
A | The full weekday name according to the current locale.
b | The abbreviated month name according to the current locale.
B | The full month name according to the current locale.
c | The preferred date and time representation for the current locale.
C | The century number (year/100) as a 2-digit integer. (SU)
d | The day of the month as a decimal number (range 01 to 31).
D | Equivalent to m/d/y.
e | Like d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)
F | Equivalent to Y-m-d (the ISO 8601 date format). (C99)
h | Equivalent to b.
H | The hour as a decimal number using a 24-hour clock (range 00 to 23).
I | The hour as a decimal number using a 12-hour clock (range 01 to 12).
j | The day of the year as a decimal number (range 001 to 366).
k | The hour (24-hour clock) as a decimal number (range 0 to 23); sin- gle digits are preceded by a blank. (See also H.)
l | The hour (12-hour clock) as a decimal number (range 1 to 12); sin- gle digits are preceded by a blank. (See also I.)
m | The month as a decimal number (range 01 to 12).
M | The minute as a decimal number (range 00 to 59).
n | A newline character. (SU)
p | Either `AM' or `PM' according to the given time value, or the cor- responding strings for the current locale. Noon is treated as `pm' and midnight as `am'.
r | The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to `I:M:S p'.
s | The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC.
S | The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.)
t | A tab character.
T | The time in 24-hour notation (H:M:S). (SU)
u | The day of the week as a decimal, range 1 to 7, Monday being 1. See also w.
V | The ISO 8601:1988 week number of the current year as a decimal num- ber, 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. See also U and W.
w | The day of the week as a decimal, range 0 to 6, Sunday being 0.
W | The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.
y | The year as a decimal number without a century (range 00 to 99).
Y | The year as a decimal number including the century.
z | The time-zone as hour offset from GMT. Required to emit RFC822-conformant dates (using "a, d b Y H:M:S z").
Z | The time zone or name or abbreviation (not implemented yet).

Syntax Specification

    <string> $date(<format:string>[,<unixtime:integer>])

Examples

        echo $date("d/m/Y H:M:S")

See also
$unixtime, $hptimestamp

Index, Functions

KVIrc 4.2.0.6190 Documentation
Generated by portbuild at Mon Aug 12 12:09:14 2013