summaryrefslogtreecommitdiff
path: root/newlib/libc/time/time.tex
diff options
context:
space:
mode:
Diffstat (limited to 'newlib/libc/time/time.tex')
-rw-r--r--newlib/libc/time/time.tex86
1 files changed, 86 insertions, 0 deletions
diff --git a/newlib/libc/time/time.tex b/newlib/libc/time/time.tex
new file mode 100644
index 00000000000..3d6dabb59ea
--- /dev/null
+++ b/newlib/libc/time/time.tex
@@ -0,0 +1,86 @@
+@node Timefns
+@chapter Time Functions (@file{time.h})
+
+This chapter groups functions used either for reporting on time
+(elapsed, current, or compute time) or to perform calculations based
+on time.
+
+The header file @file{time.h} defines three types. @code{clock_t} and
+@code{time_t} are both used for representations of time particularly
+suitable for arithmetic. (In this implementation, quantities of type
+@code{clock_t} have the highest resolution possible on your machine,
+and quantities of type @code{time_t} resolve to seconds.) @code{size_t}
+is also defined if necessary for quantities representing sizes.
+
+@file{time.h} also defines the structure @code{tm} for the traditional
+representation of Gregorian calendar time as a series of numbers, with
+the following fields:
+
+@table @code
+@item tm_sec
+Seconds.
+
+@item tm_min
+Minutes.
+
+@item tm_hour
+Hours.
+
+@item tm_mday
+Day.
+
+@item tm_mon
+Month.
+
+@item tm_year
+Year (since 1900).
+
+@item tm_wday
+Day of week: the number of days since Sunday.
+
+@item tm_yday
+Number of days elapsed since last January 1.
+
+@item tm_isdst
+Daylight Savings Time flag: positive means DST in effect, zero means DST
+not in effect, negative means no information about DST is available.
+@end table
+
+@menu
+* asctime:: Format time as string
+* clock:: Cumulative processor time
+* ctime:: Convert time to local and format as string
+* difftime:: Subtract two times
+* gmtime:: Convert time to UTC (GMT) traditional representation
+* localtime:: Convert time to local representation
+* mktime:: Convert time to arithmetic representation
+* strftime:: Flexible calendar time formatter
+* time:: Get current calendar time (as single number)
+@end menu
+
+@page
+@include time/asctime.def
+
+@page
+@include time/clock.def
+
+@page
+@include time/ctime.def
+
+@page
+@include time/difftime.def
+
+@page
+@include time/gmtime.def
+
+@page
+@include time/lcltime.def
+
+@page
+@include time/mktime.def
+
+@page
+@include time/strftime.def
+
+@page
+@include time/time.def