Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : Date and Time Functions : idate

idate

Format a local time/date as integer (PHP 5)
int idate ( string format [, int timestamp] )

Returns a number formatted according to the given format string using the given integer timestamp or the current local time if no timestamp is given. In other words, timestamp is optional and defaults to the value of time().

Unlike the function date(), idate() accepts just one char in the format parameter.

Parameters

format

Table 44. The following characters are recognized in the format parameter string

format character Description
B Swatch Beat/Internet Time
d Day of the month
h Hour (12 hour format)
H Hour (24 hour format)
i Minutes
I returns 1 if DST is activated, 0 otherwise
L returns 1 for leap year, 0 otherwise
m Month number
s Seconds
t Days in current month
U Seconds since the Unix Epoch - January 1 1970 00:00:00 GMT - this is the same as time()
w Day of the week (0 on Sunday)
W ISO-8601 week number of year, weeks starting on Monday
y Year (1 or 2 digits - check note below)
Y Year (4 digits)
z Day of the year
Z Timezone offset in seconds


timestamp

The optional timestamp parameter is an integer Unix timestamp that defaults to the current local time if a timestamp is not given. In other words, it defaults to the value of time().

Return Values

Returns an integer.

As idate() always returns an integer and as they can't start with a "0", idate() may return fewer digits than you would expect. See the example below.

Errors/Exceptions

Every call to a date/time function will generate a E_NOTICE if the time zone is not valid, and/or a E_STRICT message if using the system settings or the TZ environment variable. See also date_default_timezone_set()

ChangeLog

Version Description
5.1.0

Now issues the E_STRICT and E_NOTICE time zone errors.

Examples

Example 454. idate() example

<?php
$timestamp
= strtotime('1st January 2004'); //1072915200

// this prints the year in a two digit format
// however, as this would start with a "0", it
// only prints "4"
echo idate('y', $timestamp);
?>


See Also
date()
time()

Related Examples ( Source code ) » idate










Code Examples / Notes » idate

qjoe dot sb

To clarify an ambiguity due to the fount: 'I' is a capital i, rather than a miniscule L.

egingell

<?
// idate() for PHP < 5
// Sanity check
if (!is_callable('idate')) {
function idate($char, $ts = false) {
if ($ts === false) {
$ts = time();
} else if (!is_numeric($ts)) {
return false;
}
$char = $char{0};
if ($char == 'B') {
// Swatch time ignores the $ts argument.
return ((int) ((gmdate('U') + 3600) * (1000 / 86400))) % 1000;
} else {
return (int) date($char, $ts); // Drop leading zeroes by casting into an integer.
}
}
}
?>


Change Language


Follow Navioo On Twitter
checkdate
date_create
date_date_set
date_default_timezone_get
date_default_timezone_set
date_format
date_isodate_set
date_modify
date_offset_get
date_parse
date_sun_info
date_sunrise
date_sunset
date_time_set
date_timezone_get
date_timezone_set
date
getdate
gettimeofday
gmdate
gmmktime
gmstrftime
idate
localtime
microtime
mktime
strftime
strptime
strtotime
time
timezone_abbreviations_list
timezone_identifiers_list
timezone_name_from_abbr
timezone_name_get
timezone_offset_get
timezone_open
timezone_transitions_get
eXTReMe Tracker