datetime(3) [debian man page]

datetime(3)						     Library Functions Manual						       datetime(3)

NAME

       datetime - convert between TAI labels and seconds

SYNTAX

       #include <datetime.h>

       void datetime_tai(&dt,t);

       datetime_sec datetime_untai(&dt);

       struct datetime dt;
       datetime_sec t;

DESCRIPTION

       International  Atomic  Time,  TAI, is the fundamental unit for time measurements.  TAI has one label for every second of real time, without
       complications such as leap seconds.

       A struct datetime variable, such as dt, stores a TAI label.  dt.year is the year number minus 1900; dt.mon is  the  month  number,  from  0
       (January)  through 11 (December); dt.mday is the day of the month, from 1 through 31; dt.hour is the hour, from 0 through 23; dt.min is the
       minute, from 0 through 59; dt.sec is the second, from 0 through 59; dt.wday is the day of the week, from 0 (Sunday) through  6  (Saturday);
       dt.yday is the day of the year, from 0 through 365.

       The  datetime library supports more convenient TAI manipulation with the datetime_sec type.  A datetime_sec value, such as t, is an integer
       referring to the tth second after the beginning of 1970 TAI.  The first second of 1970 TAI was 0; the next second was 1; the last second of
       1969 TAI was -1.  The difference between two datetime_sec values is a number of real-time seconds.

       datetime_tai converts a datetime_sec to a TAI label.

       datetime_untai reads a TAI label (specifically dt.year, dt.mon, dt.mday, dt.hour, dt.min, and dt.sec) and returns a datetime_sec.

SEE ALSO

       now(3)

																       datetime(3)

GETDATE(3)								 1								GETDATE(3)

getdate - Get date/time information

SYNOPSIS

       array getdate ([int  $timestamp = time()])

DESCRIPTION

	Returns an associative array containing the date information of the $timestamp, or the current local time if no $timestamp is given.

PARAMETERS

	      o $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(3).

RETURN VALUES

	Returns an associative array of information related to the $timestamp. Elements from the returned associative array are as follows:

       Key elements of the returned associative array

       +----------+--------------------------------------+---+
       |   Key	  |					 |   |
       |	  |					 |   |
       |	  |		Description		 |   |
       |	  |					 |   |
       |	  |	  Example returned values	 |   |
       |	  |					 |   |
       +----------+--------------------------------------+---+
       |	  |					 |   |
       |"seconds" |					 |   |
       |	  |					 |   |
       |	  |  Numeric representation of seconds	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  0 to 59		 |   |
       |	  |					 |   |
       |	  |					 |   |
       |"minutes" |					 |   |
       |	  |					 |   |
       |	  |  Numeric representation of minutes	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  0 to 59		 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "hours"  |					 |   |
       |	  |					 |   |
       |	  |   Numeric representation of hours	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  0 to 23		 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "mday"   |					 |   |
       |	  |					 |   |
       |	  | Numeric representation of the day of |   |
       |	  | the month				 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		  1 to 31		 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "wday"   |					 |   |
       |	  |					 |   |
       |	  | Numeric representation of the day of |   |
       |	  | the week				 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  | 0 (for Sunday) through 6 (for Satur- |   |
       |	  | day)				 |   |
       |	  |					 |   |
       |	  |					 |   |
       |  "mon"   |					 |   |
       |	  |					 |   |
       |	  |  Numeric representation of a month	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |		1 through 12		 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "year"   |					 |   |
       |	  |					 |   |
       |	  | A  full  numeric representation of a |   |
       |	  | year, 4 digits			 |   |
       |	  |					 |   |
       |	  |	   Examples: 1999 or 2003	 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "yday"   |					 |   |
       |	  |					 |   |
       |	  | Numeric representation of the day of |   |
       |	  | the year				 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |	       0 through 365		 |   |
       |	  |					 |   |
       |	  |					 |   |
       |"weekday" |					 |   |
       |	  |					 |   |
       |	  | A full textual representation of the |   |
       |	  | day of the week			 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |	  Sunday through Saturday	 |   |
       |	  |					 |   |
       |	  |					 |   |
       | "month"  |					 |   |
       |	  |					 |   |
       |	  | A full textual representation  of  a |   |
       |	  | month, such as January or March	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |	  |	  January through December	 |   |
       |	  |					 |   |
       |	  |					 |   |
       |    0	  |					 |   |
       |	  |					 |   |
       |	  |  Seconds since the Unix Epoch, simi- |   |
       |	  | lar  to  the  values   returned   by |   |
       |	  | time(3) and used by date(3).	 |   |
       |	  |					 |   |
       |	  |  System	Dependent,     typically |   |
       |	  | -2147483648 through 2147483647.	 |   |
       |	  |					 |   |
       +----------+--------------------------------------+---+
EXAMPLES

       Example #1

	      getdate(3) example

	      <?php
	      $today = getdate();
	      print_r($today);
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [seconds] => 40
		  [minutes] => 58
		  [hours]   => 21
		  [mday]    => 17
		  [wday]    => 2
		  [mon]     => 6
		  [year]    => 2003
		  [yday]    => 167
		  [weekday] => Tuesday
		  [month]   => June
		  [0]	    => 1055901520
	      )

SEE ALSO

       date(3), idate(3), localtime(3), time(3), setlocale(3).

PHP Documentation Group 														GETDATE(3)