summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pr_gmtparameters.rst
blob: d9abb9c0b69dbc66d8e08b0b36fa7c1b6bb7fc5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
PR_GMTParameters
================

Returns the time zone offset information that maps the specified
:ref:`PRExplodedTime` to GMT.

.. note::

   **Note:** Since this function requires GMT as input, its primary use
   is as "filler" for cases in which you need a do-nothing callback.


Syntax
------

.. code::

   #include <prtime.h>

   PRTimeParameters PR_GMTParameters (
      const PRExplodedTime *gmt);


Parameter
~~~~~~~~~

``gmt``
   A pointer to the clock/calendar time whose offsets are to be
   determined. This time should be specified in GMT.


Returns
~~~~~~~

A time parameters structure that expresses the time zone offsets at the
specified time.


Description
-----------

This is a frequently-used time parameter callback function. You don't
normally call it directly; instead, you pass it as a parameter to
``PR_ExplodeTime()`` or ``PR_NormalizeTime()``.

This is a trivial function; for any input, it returns a
:ref:`PRTimeParameters` structure with both fields set to zero.