glib-date-and-time-functions.html

最新gtk中文资料集

</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3035932"></a><h3>
<a name="GTime"></a>GTime</h3>
<a class="indexterm" name="id3035944"></a><pre class="programlisting">typedef gint32  GTime;
</pre>
<p>
Simply a replacement for <span class="type">time_t</span>. It has been deprected
since it is <span class="emphasis"><em>not</em></span> equivalent to <span class="type">time_t</span> 
on 64-bit platforms with a 64-bit <span class="type">time_t</span>. 
Unrelated to <a class="link" href="glib-Timers.html#GTimer"><span class="type">GTimer</span></a>.
</p>
<p>
Note that <span class="type">GTime</span> is defined to always be a 32bit integer,
unlike <span class="type">time_t</span> which may be 64bit on some systems. 
Therefore, <span class="type">GTime</span> will overflow in the year 2038, and
you cannot use the address of a <span class="type">GTime</span> variable as argument 
to the UNIX <code class="function">time()</code> function. Instead, do the following:
</p>
<div class="informalexample"><pre class="programlisting">
time_t ttime;
GTime gtime;

time (&amp;ttime);
gtime = (GTime)ttime;
</pre></div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3036029"></a><h3>
<a name="GDateDMY"></a>enum GDateDMY</h3>
<a class="indexterm" name="id3036041"></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 class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-DATE-DAY:CAPS"></a><code class="literal">G_DATE_DAY</code></span></p></td>
<td>a day
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-MONTH:CAPS"></a><code class="literal">G_DATE_MONTH</code></span></p></td>
<td>a month
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-YEAR:CAPS"></a><code class="literal">G_DATE_YEAR</code></span></p></td>
<td>a year

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3036129"></a><h3>
<a name="GDateDay"></a>GDateDay</h3>
<a class="indexterm" name="id3036142"></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 class="link" 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="id3036167"></a><h3>
<a name="GDateMonth"></a>enum GDateMonth</h3>
<a class="indexterm" name="id3036179"></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 <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-JANUARY:CAPS"><span class="type">G_DATE_JANUARY</span></a>,
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-FEBRUARY:CAPS"><span class="type">G_DATE_FEBRUARY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-MONTH:CAPS"><span class="type">G_DATE_BAD_MONTH</span></a> is the invalid value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-DATE-BAD-MONTH:CAPS"></a><code class="literal">G_DATE_BAD_MONTH</code></span></p></td>
<td>invalid value
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-JANUARY:CAPS"></a><code class="literal">G_DATE_JANUARY</code></span></p></td>
<td>January
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-FEBRUARY:CAPS"></a><code class="literal">G_DATE_FEBRUARY</code></span></p></td>
<td>February
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-MARCH:CAPS"></a><code class="literal">G_DATE_MARCH</code></span></p></td>
<td>March
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-APRIL:CAPS"></a><code class="literal">G_DATE_APRIL</code></span></p></td>
<td>April
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-MAY:CAPS"></a><code class="literal">G_DATE_MAY</code></span></p></td>
<td>May
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-JUNE:CAPS"></a><code class="literal">G_DATE_JUNE</code></span></p></td>
<td>June
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-JULY:CAPS"></a><code class="literal">G_DATE_JULY</code></span></p></td>
<td>July
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-AUGUST:CAPS"></a><code class="literal">G_DATE_AUGUST</code></span></p></td>
<td>August
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-SEPTEMBER:CAPS"></a><code class="literal">G_DATE_SEPTEMBER</code></span></p></td>
<td>September
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-OCTOBER:CAPS"></a><code class="literal">G_DATE_OCTOBER</code></span></p></td>
<td>October
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-NOVEMBER:CAPS"></a><code class="literal">G_DATE_NOVEMBER</code></span></p></td>
<td>November
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-DECEMBER:CAPS"></a><code class="literal">G_DATE_DECEMBER</code></span></p></td>
<td>December

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3036520"></a><h3>
<a name="GDateYear"></a>GDateYear</h3>
<a class="indexterm" name="id3036532"></a><pre class="programlisting">typedef guint16 GDateYear;
</pre>
<p>
Integer representing a year; <a class="link" 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="id3036559"></a><h3>
<a name="GDateWeekday"></a>enum GDateWeekday</h3>
<a class="indexterm" name="id3036571"></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; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-MONDAY:CAPS"><span class="type">G_DATE_MONDAY</span></a>,
<a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-TUESDAY:CAPS"><span class="type">G_DATE_TUESDAY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-WEEKDAY:CAPS"><span class="type">G_DATE_BAD_WEEKDAY</span></a> is an invalid weekday.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-DATE-BAD-WEEKDAY:CAPS"></a><code class="literal">G_DATE_BAD_WEEKDAY</code></span></p></td>
<td>invalid value
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-MONDAY:CAPS"></a><code class="literal">G_DATE_MONDAY</code></span></p></td>
<td>Monday
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-TUESDAY:CAPS"></a><code class="literal">G_DATE_TUESDAY</code></span></p></td>
<td>Tuesday
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-DATE-WEDNESDAY:CAPS"></a><code class="literal">G_DATE_WEDNESDAY</code></span></p></td>
<td>Wednesday
</td>
</tr>