xref: /dflybsd-src/lib/libc/stdtime/offtime.3 (revision c17b1a1f2f1a2a29db36c9fb8269b89989d5d33c)
1*c17b1a1fSSascha Wildner.\"	$NetBSD: offtime.3,v 1.4 2017/10/25 19:01:25 abhinav Exp $
2*c17b1a1fSSascha Wildner.\" Written by Klaus Klein, May 10, 2004.
3*c17b1a1fSSascha Wildner.\" Public domain.
4*c17b1a1fSSascha Wildner.Dd May 4, 2019
5*c17b1a1fSSascha Wildner.Dt OFFTIME 3
6*c17b1a1fSSascha Wildner.Os
7*c17b1a1fSSascha Wildner.Sh NAME
8*c17b1a1fSSascha Wildner.Nm offtime ,
9*c17b1a1fSSascha Wildner.Nm timeoff ,
10*c17b1a1fSSascha Wildner.Nm timelocal
11*c17b1a1fSSascha Wildner.Nd convert date and time
12*c17b1a1fSSascha Wildner.Sh LIBRARY
13*c17b1a1fSSascha Wildner.Lb libc
14*c17b1a1fSSascha Wildner.Sh SYNOPSIS
15*c17b1a1fSSascha Wildner.In time.h
16*c17b1a1fSSascha Wildner.Ft struct tm *
17*c17b1a1fSSascha Wildner.Fn offtime "const time_t * clock" "long int offset"
18*c17b1a1fSSascha Wildner.Ft time_t
19*c17b1a1fSSascha Wildner.Fn timeoff "struct tm * tm" "long int offset"
20*c17b1a1fSSascha Wildner.Ft time_t
21*c17b1a1fSSascha Wildner.Fn timelocal "struct tm * tm"
22*c17b1a1fSSascha Wildner.Sh DESCRIPTION
23*c17b1a1fSSascha WildnerThese functions are inspired by C standard interfaces named similarly.
24*c17b1a1fSSascha Wildner.Pp
25*c17b1a1fSSascha Wildner.Fn offtime
26*c17b1a1fSSascha Wildnerconverts the calendar time
27*c17b1a1fSSascha Wildner.Fa clock ,
28*c17b1a1fSSascha Wildneroffset by
29*c17b1a1fSSascha Wildner.Fa offset
30*c17b1a1fSSascha Wildnerseconds,
31*c17b1a1fSSascha Wildnerinto broken-down time, expressed as Coordinated Universal Time (UTC).
32*c17b1a1fSSascha Wildner.Pp
33*c17b1a1fSSascha Wildner.Fn timeoff
34*c17b1a1fSSascha Wildnerconverts the broken-down time
35*c17b1a1fSSascha Wildner.Fa tm ,
36*c17b1a1fSSascha Wildnerexpressed as UTC,
37*c17b1a1fSSascha Wildneroffset by
38*c17b1a1fSSascha Wildner.Fa offset
39*c17b1a1fSSascha Wildnerseconds,
40*c17b1a1fSSascha Wildnerinto a calendar time value.
41*c17b1a1fSSascha Wildner.Pp
42*c17b1a1fSSascha Wildner.Fn timelocal
43*c17b1a1fSSascha Wildnerconverts the broken down time
44*c17b1a1fSSascha Wildner.Fa tm ,
45*c17b1a1fSSascha Wildnerexpressed as local time, into a calendar time value.
46*c17b1a1fSSascha WildnerIt is equivalent to the C standard function
47*c17b1a1fSSascha Wildner.Xr mktime 3 ,
48*c17b1a1fSSascha Wildnerand is provided for symmetry only.
49*c17b1a1fSSascha Wildner.Sh SEE ALSO
50*c17b1a1fSSascha Wildner.Xr ctime 3 ,
51*c17b1a1fSSascha Wildner.\".Xr tm 3 ,
52*c17b1a1fSSascha Wildner.Xr tzset 3
53