Python Date Time
Python Date Time
Python Date Time
http://www.tutorialspoint.com/python/python_date_time.htm
Copyright tutorialspoint.com
A Python program can handle date & time in several ways. Converting between date formats is a common chore for
computers. Python's time and calendar modules help track dates and times.
What is Tick?
Time intervals are floating-point numbers in units of seconds. Particular instants in time are expressed in seconds since
12:00am, January 1, 1970(epoch).
There is a popular time module available in Python which provides functions for working with times, and for
converting between representations. The function time.time() returns the current system time in ticks since 12:00am,
January 1, 1970(epoch).
Example:
#!/usr/bin/python
import time; # This is required to include time module.
ticks = time.time()
print "Number of ticks since 12:00am, January 1, 1970:", ticks
Date arithmetic is easy to do with ticks. However, dates before the epoch cannot be represented in this form. Dates in
the far future also cannot be represented this way - the cutoff point is sometime in 2038 for UNIX and Windows.
What is TimeTuple?
Many of Python's time functions handle time as a tuple of 9 numbers, as shown below:
Index
Field
Values
4-digit year
2008
Month
1 to 12
Day
1 to 31
Hour
0 to 23
Minute
0 to 59
Second
Day of Week
0 to 6 (0 is Monday)
Day of year
Daylight savings
The above tuple is equivalent to struct_time structure. This structure has following attributes:
Index
Attributes
Values
tm_year
2008
tm_mon
1 to 12
tm_mday
1 to 31
tm_hour
0 to 23
tm_min
0 to 59
tm_sec
tm_wday
0 to 6 (0 is Monday)
tm_yday
tm_isdst
This would produce following result which could be formatted in any other presentable form:
Local current time : (2008, 5, 15, 12, 55, 32, 0, 136, 1)
#!/usr/bin/python
import calendar
cal = calendar.month(2008, 1)
print "Here is the calendar:"
print cal;
calendar:
2008
Fr Sa Su
4 5 6
11 12 13
18 19 20
25 26 27
SN
time.altzone
The offset of the local DST timezone, in seconds west of UTC, if one is defined. This is negative if the local
DST timezone is east of UTC (as in Western Europe, including the UK). Only use this if daylight is nonzero.
time.asctime([tupletime])
Accepts a time-tuple and returns a readable 24-character string such as 'Tue Dec 11 18:07:14 2008'.
time.clock( )
Returns the current CPU time as a floating-point number of seconds. To measure computational costs of
different approaches, the value of time.clock is more useful than that of time.time().
time.ctime([secs])
Like asctime(localtime(secs)) and without arguments is like asctime( )
time.gmtime([secs])
Accepts an instant expressed in seconds since the epoch and returns a time-tuple t with the UTC time. Note :
t.tm_isdst is always 0
time.localtime([secs])
Accepts an instant expressed in seconds since the epoch and returns a time-tuple t with the local time
(t.tm_isdst is 0 or 1, depending on whether DST applies to instant secs by local rules).
time.mktime(tupletime)
Accepts an instant expressed as a time-tuple in local time and returns a floating-point value with the instant
expressed in seconds since the epoch.
time.sleep(secs)
Suspends the calling thread for secs seconds.
time.strftime(fmt[,tupletime])
Accepts an instant expressed as a time-tuple in local time and returns a string representing the instant as
specified by string fmt.
10
11
time.time( )
Returns the current time instant, a floating-point number of seconds since the epoch.
12
time.tzset()
Resets the time conversion rules used by the library routines. The environment variable TZ specifies how this
is done.
There are following two important attributes available with time module:
SN
time.timezone
Attribute time.timezone is the offset in seconds of the local time zone (without DST) from UTC (>0 in the
Americas; <=0 in most of Europe, Asia, Africa).
time.tzname
Attribute time.tzname is a pair of locale-dependent strings, which are the names of the local time zone without
and with DST, respectively.
SN
calendar.calendar(year,w=2,l=1,c=6)
Returns a multiline string with a calendar for year year formatted into three columns separated by c spaces. w
is the width in characters of each date; each line has length 21*w+18+2*c. l is the number of lines for each
week.
calendar.firstweekday( )
Returns the current setting for the weekday that starts each week. By default, when calendar is first imported,
this is 0, meaning Monday.
calendar.isleap(year)
Returns True if year is a leap year; otherwise, False.
calendar.leapdays(y1,y2)
Returns the total number of leap days in the years within range(y1,y2).
calendar.month(year,month,w=2,l=1)
Returns a multiline string with a calendar for month month of year year, one line per week plus two header
lines. w is the width in characters of each date; each line has length 7*w+6. l is the number of lines for each
week.
6
calendar.monthcalendar(year,month)
Returns a list of lists of ints. Each sublist denotes a week. Days outside month month of year year are set to 0;
days within the month are set to their day-of-month, 1 and up.
calendar.monthrange(year,month)
Returns two integers. The first one is the code of the weekday for the first day of the month month in year
year; the second one is the number of days in the month. Weekday codes are 0 (Monday) to 6 (Sunday);
month numbers are 1 to 12.
calendar.prcal(year,w=2,l=1,c=6)
Like print calendar.calendar(year,w,l,c).
calendar.prmonth(year,month,w=2,l=1)
Like print calendar.month(year,month,w,l).
10
calendar.setfirstweekday(weekday)
Sets the first day of each week to weekday code weekday. Weekday codes are 0 (Monday) to 6 (Sunday).
11
calendar.timegm(tupletime)
The inverse of time.gmtime: accepts a time instant in time-tuple form and returns the same instant as a
floating-point number of seconds since the epoch.
12
calendar.weekday(year,month,day)
Returns the weekday code for the given date. Weekday codes are 0 (Monday) to 6 (Sunday); month numbers
are 1 (January) to 12 (December).