glib-date-and-time-functions.html

glid编写实例

<div class="refsect2" lang="en">
<a name="id2990240"></a><h3>
<a name="g-time-val-add"></a>g_time_val_add ()</h3>
<a class="indexterm" name="id2990250"></a><pre class="programlisting">void        g_time_val_add                  (<a href="glib-Date-and-Time-Functions.html#GTimeVal">GTimeVal</a> *time_,
                                             <a href="glib-Basic-Types.html#glong">glong</a> microseconds);</pre>
<p>
Adds the given number of microseconds to <em class="parameter"><code>time_</code></em>. <em class="parameter"><code>microseconds</code></em> can
also be negative to decrease the value of <em class="parameter"><code>time_</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>time_</code></em>&#160;:</span></td>
<td> a <a href="glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>microseconds</code></em>&#160;:</span></td>
<td> number of microseconds to add to <em class="parameter"><code>time</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990354"></a><h3>
<a name="GDate"></a>GDate</h3>
<a class="indexterm" name="id2990364"></a><pre class="programlisting">typedef struct {
  guint julian_days : 32; /* julian days representation - we use a
                           *  bitfield hoping that 64 bit platforms
                           *  will pack this whole struct in one big
                           *  int
                           */

  guint julian : 1;    /* julian is valid */
  guint dmy    : 1;    /* dmy is valid */

  /* DMY representation */
  guint day    : 6;
  guint month  : 4;
  guint year   : 16;
} GDate;
</pre>
<p>
Represents a day between January 1, Year 1 and a few thousand years in
the future. None of its members should be accessed directly. If the
<span class="structname">GDate</span> is obtained from <a href="glib-Date-and-Time-Functions.html#g-date-new"><code class="function">g_date_new()</code></a>, it will
be safe to mutate but invalid and thus not safe for calendrical computations.
If it's declared on the stack, it will contain garbage so must be
initialized with <a href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a>. <a href="glib-Date-and-Time-Functions.html#g-date-clear"><code class="function">g_date_clear()</code></a> makes the date invalid
but sane. An invalid date doesn't represent a day, it's "empty." A
date becomes valid after you set it to a Julian day or you set a day,
month, and year.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990438"></a><h3>
<a name="GTime"></a>GTime</h3>
<a class="indexterm" name="id2990448"></a><pre class="programlisting">typedef gint32  GTime;
</pre>
<p>
Simply a replacement for <span class="type">time_t</span>. Unrelated to <a href="glib-Timers.html#GTimer"><span class="type">GTimer</span></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990476"></a><h3>
<a name="GDateDMY"></a>enum GDateDMY</h3>
<a class="indexterm" name="id2990487"></a><pre class="programlisting">typedef enum
{
  G_DATE_DAY   = 0,
  G_DATE_MONTH = 1,
  G_DATE_YEAR  = 2
} GDateDMY;
</pre>
<p>
This enumeration isn't used in the API, but may be useful if you need
to mark a number as a day, month, or year.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990505"></a><h3>
<a name="GDateDay"></a>GDateDay</h3>
<a class="indexterm" name="id2990515"></a><pre class="programlisting">typedef guint8  GDateDay;   /* day of the month */
</pre>
<p>
Integer representing a day of the month; between 1 and
31. <a href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY:CAPS"><span class="type">G_DATE_BAD_DAY</span></a> represents an invalid day of the month.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990541"></a><h3>
<a name="GDateMonth"></a>enum GDateMonth</h3>
<a class="indexterm" name="id2990552"></a><pre class="programlisting">typedef enum
{
  G_DATE_BAD_MONTH = 0,
  G_DATE_JANUARY   = 1,
  G_DATE_FEBRUARY  = 2,
  G_DATE_MARCH     = 3,
  G_DATE_APRIL     = 4,
  G_DATE_MAY       = 5,
  G_DATE_JUNE      = 6,
  G_DATE_JULY      = 7,
  G_DATE_AUGUST    = 8,
  G_DATE_SEPTEMBER = 9,
  G_DATE_OCTOBER   = 10,
  G_DATE_NOVEMBER  = 11,
  G_DATE_DECEMBER  = 12
} GDateMonth;
</pre>
<p>
Enumeration representing a month; values are <span class="type">G_DATE_JANUARY</span>,
<span class="type">G_DATE_FEBRUARY</span>, etc. <span class="type">G_DATE_BAD_MONTH</span> is the invalid value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_BAD_MONTH</code></span></td>
<td>invalid value.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_JANUARY</code></span></td>
<td>January.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_FEBRUARY</code></span></td>
<td>February.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_MARCH</code></span></td>
<td>March.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_APRIL</code></span></td>
<td>April.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_MAY</code></span></td>
<td>May.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_JUNE</code></span></td>
<td>June.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_JULY</code></span></td>
<td>July.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_AUGUST</code></span></td>
<td>August.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_SEPTEMBER</code></span></td>
<td>September.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_OCTOBER</code></span></td>
<td>October.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_NOVEMBER</code></span></td>
<td>November.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_DECEMBER</code></span></td>
<td>December.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990797"></a><h3>
<a name="GDateYear"></a>GDateYear</h3>
<a class="indexterm" name="id2990807"></a><pre class="programlisting">typedef guint16 GDateYear;
</pre>
<p>
Integer representing a year; <a href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR:CAPS"><span class="type">G_DATE_BAD_YEAR</span></a> is the invalid
value. The year must be 1 or higher; negative (BC) years are not
allowed. The year is represented with four digits.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2990834"></a><h3>
<a name="GDateWeekday"></a>enum GDateWeekday</h3>
<a class="indexterm" name="id2990845"></a><pre class="programlisting">typedef enum
{
  G_DATE_BAD_WEEKDAY  = 0,
  G_DATE_MONDAY       = 1,
  G_DATE_TUESDAY      = 2,
  G_DATE_WEDNESDAY    = 3,
  G_DATE_THURSDAY     = 4,
  G_DATE_FRIDAY       = 5,
  G_DATE_SATURDAY     = 6,
  G_DATE_SUNDAY       = 7
} GDateWeekday;
</pre>
<p>
Enumeration representing a day of the week; <span class="type">G_DATE_MONDAY</span>,
<span class="type">G_DATE_TUESDAY</span>, etc. <span class="type">G_DATE_BAD_WEEKDAY</span> is an invalid weekday.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_BAD_WEEKDAY</code></span></td>
<td>invalid value.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_MONDAY</code></span></td>
<td>Monday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_TUESDAY</code></span></td>
<td>Tuesday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_WEDNESDAY</code></span></td>
<td>Wednesday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_THURSDAY</code></span></td>
<td>Thursday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_FRIDAY</code></span></td>
<td>Friday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_SATURDAY</code></span></td>
<td>Saturday.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_DATE_SUNDAY</code></span></td>
<td>Sunday.

</td>