~ubuntu-branches/ubuntu/saucy/glib2.0/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/tmpl/date.sgml

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2013-08-21 10:08:49 UTC
  • mfrom: (1.63.24)
  • Revision ID: package-import@ubuntu.com-20130821100849-enhti9o2tk0iug5r
Tags: 2.37.6-1ubuntu1
* Resynchronise with Debian, remaining change:
  - Build-Depend on python:any for cross-building.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- ##### SECTION Title ##### -->
 
2
Date and Time Functions
 
3
 
 
4
<!-- ##### SECTION Short_Description ##### -->
 
5
 
 
6
 
 
7
<!-- ##### SECTION Long_Description ##### -->
 
8
<para>
 
9
 
 
10
</para>
 
11
 
 
12
 
 
13
<!-- ##### SECTION See_Also ##### -->
 
14
<para>
 
15
 
 
16
</para>
 
17
 
 
18
 
 
19
<!-- ##### SECTION Stability_Level ##### -->
 
20
 
 
21
 
 
22
<!-- ##### SECTION Image ##### -->
 
23
 
 
24
 
 
25
<!-- ##### MACRO G_USEC_PER_SEC ##### -->
 
26
<para>
 
27
 
 
28
</para>
 
29
 
 
30
 
 
31
 
 
32
<!-- ##### STRUCT GTimeVal ##### -->
 
33
<para>
 
34
 
 
35
</para>
 
36
 
 
37
@tv_sec: 
 
38
@tv_usec: 
 
39
 
 
40
<!-- ##### FUNCTION g_get_current_time ##### -->
 
41
<para>
 
42
 
 
43
</para>
 
44
 
 
45
@result: 
 
46
 
 
47
 
 
48
<!-- ##### FUNCTION g_usleep ##### -->
 
49
<para>
 
50
 
 
51
</para>
 
52
 
 
53
@microseconds: 
 
54
 
 
55
 
 
56
<!-- ##### FUNCTION g_time_val_add ##### -->
 
57
<para>
 
58
 
 
59
</para>
 
60
 
 
61
@time_: 
 
62
@microseconds: 
 
63
 
 
64
 
 
65
<!-- ##### FUNCTION g_time_val_from_iso8601 ##### -->
 
66
<para>
 
67
 
 
68
</para>
 
69
 
 
70
@iso_date: 
 
71
@time_: 
 
72
@Returns: 
 
73
 
 
74
 
 
75
<!-- ##### FUNCTION g_time_val_to_iso8601 ##### -->
 
76
<para>
 
77
 
 
78
</para>
 
79
 
 
80
@time_: 
 
81
@Returns: 
 
82
 
 
83
 
 
84
<!-- ##### FUNCTION g_get_monotonic_time ##### -->
 
85
<para>
 
86
 
 
87
</para>
 
88
 
 
89
@void: 
 
90
@Returns: 
 
91
 
 
92
 
 
93
<!-- ##### FUNCTION g_get_real_time ##### -->
 
94
<para>
 
95
 
 
96
</para>
 
97
 
 
98
@void: 
 
99
@Returns: 
 
100
 
 
101
 
 
102
<!-- ##### STRUCT GDate ##### -->
 
103
<para>
 
104
 
 
105
</para>
 
106
 
 
107
@julian_days: 
 
108
@julian: 
 
109
@dmy: 
 
110
@day: 
 
111
@month: 
 
112
@year: 
 
113
 
 
114
<!-- ##### TYPEDEF GTime ##### -->
 
115
<para>
 
116
 
 
117
</para>
 
118
 
 
119
 
 
120
<!-- ##### ENUM GDateDMY ##### -->
 
121
<para>
 
122
 
 
123
</para>
 
124
 
 
125
@G_DATE_DAY: 
 
126
@G_DATE_MONTH: 
 
127
@G_DATE_YEAR: 
 
128
 
 
129
<!-- ##### TYPEDEF GDateDay ##### -->
 
130
<para>
 
131
 
 
132
</para>
 
133
 
 
134
 
 
135
<!-- ##### ENUM GDateMonth ##### -->
 
136
<para>
 
137
 
 
138
</para>
 
139
 
 
140
@G_DATE_BAD_MONTH: 
 
141
@G_DATE_JANUARY: 
 
142
@G_DATE_FEBRUARY: 
 
143
@G_DATE_MARCH: 
 
144
@G_DATE_APRIL: 
 
145
@G_DATE_MAY: 
 
146
@G_DATE_JUNE: 
 
147
@G_DATE_JULY: 
 
148
@G_DATE_AUGUST: 
 
149
@G_DATE_SEPTEMBER: 
 
150
@G_DATE_OCTOBER: 
 
151
@G_DATE_NOVEMBER: 
 
152
@G_DATE_DECEMBER: 
 
153
 
 
154
<!-- ##### TYPEDEF GDateYear ##### -->
 
155
<para>
 
156
 
 
157
</para>
 
158
 
 
159
 
 
160
<!-- ##### ENUM GDateWeekday ##### -->
 
161
<para>
 
162
 
 
163
</para>
 
164
 
 
165
@G_DATE_BAD_WEEKDAY: 
 
166
@G_DATE_MONDAY: 
 
167
@G_DATE_TUESDAY: 
 
168
@G_DATE_WEDNESDAY: 
 
169
@G_DATE_THURSDAY: 
 
170
@G_DATE_FRIDAY: 
 
171
@G_DATE_SATURDAY: 
 
172
@G_DATE_SUNDAY: 
 
173
 
 
174
<!-- ##### MACRO G_DATE_BAD_DAY ##### -->
 
175
<para>
 
176
 
 
177
</para>
 
178
 
 
179
 
 
180
 
 
181
<!-- ##### MACRO G_DATE_BAD_JULIAN ##### -->
 
182
<para>
 
183
 
 
184
</para>
 
185
 
 
186
 
 
187
 
 
188
<!-- ##### MACRO G_DATE_BAD_YEAR ##### -->
 
189
<para>
 
190
 
 
191
</para>
 
192
 
 
193
 
 
194
 
 
195
<!-- ##### FUNCTION g_date_new ##### -->
 
196
<para>
 
197
 
 
198
</para>
 
199
 
 
200
@void: 
 
201
@Returns: 
 
202
 
 
203
 
 
204
<!-- ##### FUNCTION g_date_new_dmy ##### -->
 
205
<para>
 
206
 
 
207
</para>
 
208
 
 
209
@day: 
 
210
@month: 
 
211
@year: 
 
212
@Returns: 
 
213
 
 
214
 
 
215
<!-- ##### FUNCTION g_date_new_julian ##### -->
 
216
<para>
 
217
 
 
218
</para>
 
219
 
 
220
@julian_day: 
 
221
@Returns: 
 
222
 
 
223
 
 
224
<!-- ##### FUNCTION g_date_clear ##### -->
 
225
<para>
 
226
 
 
227
</para>
 
228
 
 
229
@date: 
 
230
@n_dates: 
 
231
 
 
232
 
 
233
<!-- ##### FUNCTION g_date_free ##### -->
 
234
<para>
 
235
 
 
236
</para>
 
237
 
 
238
@date: 
 
239
 
 
240
 
 
241
<!-- ##### FUNCTION g_date_set_day ##### -->
 
242
<para>
 
243
 
 
244
</para>
 
245
 
 
246
@date: 
 
247
@day: 
 
248
 
 
249
 
 
250
<!-- ##### FUNCTION g_date_set_month ##### -->
 
251
<para>
 
252
 
 
253
</para>
 
254
 
 
255
@date: 
 
256
@month: 
 
257
 
 
258
 
 
259
<!-- ##### FUNCTION g_date_set_year ##### -->
 
260
<para>
 
261
 
 
262
</para>
 
263
 
 
264
@date: 
 
265
@year: 
 
266
 
 
267
 
 
268
<!-- ##### FUNCTION g_date_set_dmy ##### -->
 
269
<para>
 
270
 
 
271
</para>
 
272
 
 
273
@date: 
 
274
@day: 
 
275
@month: 
 
276
@y: 
 
277
 
 
278
 
 
279
<!-- ##### FUNCTION g_date_set_julian ##### -->
 
280
<para>
 
281
 
 
282
</para>
 
283
 
 
284
@date: 
 
285
@julian_date: 
 
286
 
 
287
 
 
288
<!-- ##### FUNCTION g_date_set_time ##### -->
 
289
<para>
 
290
 
 
291
</para>
 
292
 
 
293
@date: 
 
294
@time_: 
 
295
 
 
296
 
 
297
<!-- ##### FUNCTION g_date_set_time_t ##### -->
 
298
<para>
 
299
 
 
300
</para>
 
301
 
 
302
@date: 
 
303
@timet: 
 
304
 
 
305
 
 
306
<!-- ##### FUNCTION g_date_set_time_val ##### -->
 
307
<para>
 
308
 
 
309
</para>
 
310
 
 
311
@date: 
 
312
@timeval: 
 
313
 
 
314
 
 
315
<!-- ##### FUNCTION g_date_set_parse ##### -->
 
316
<para>
 
317
 
 
318
</para>
 
319
 
 
320
@date: 
 
321
@str: 
 
322
 
 
323
 
 
324
<!-- ##### FUNCTION g_date_add_days ##### -->
 
325
<para>
 
326
 
 
327
</para>
 
328
 
 
329
@date: 
 
330
@n_days: 
 
331
 
 
332
 
 
333
<!-- ##### FUNCTION g_date_subtract_days ##### -->
 
334
<para>
 
335
 
 
336
</para>
 
337
 
 
338
@date: 
 
339
@n_days: 
 
340
 
 
341
 
 
342
<!-- ##### FUNCTION g_date_add_months ##### -->
 
343
<para>
 
344
 
 
345
</para>
 
346
 
 
347
@date: 
 
348
@n_months: 
 
349
 
 
350
 
 
351
<!-- ##### FUNCTION g_date_subtract_months ##### -->
 
352
<para>
 
353
 
 
354
</para>
 
355
 
 
356
@date: 
 
357
@n_months: 
 
358
 
 
359
 
 
360
<!-- ##### FUNCTION g_date_add_years ##### -->
 
361
<para>
 
362
 
 
363
</para>
 
364
 
 
365
@date: 
 
366
@n_years: 
 
367
 
 
368
 
 
369
<!-- ##### FUNCTION g_date_subtract_years ##### -->
 
370
<para>
 
371
 
 
372
</para>
 
373
 
 
374
@date: 
 
375
@n_years: 
 
376
 
 
377
 
 
378
<!-- ##### FUNCTION g_date_days_between ##### -->
 
379
<para>
 
380
 
 
381
</para>
 
382
 
 
383
@date1: 
 
384
@date2: 
 
385
@Returns: 
 
386
 
 
387
 
 
388
<!-- ##### FUNCTION g_date_compare ##### -->
 
389
<para>
 
390
 
 
391
</para>
 
392
 
 
393
@lhs: 
 
394
@rhs: 
 
395
@Returns: 
 
396
 
 
397
 
 
398
<!-- ##### FUNCTION g_date_clamp ##### -->
 
399
<para>
 
400
 
 
401
</para>
 
402
 
 
403
@date: 
 
404
@min_date: 
 
405
@max_date: 
 
406
 
 
407
 
 
408
<!-- ##### FUNCTION g_date_order ##### -->
 
409
<para>
 
410
 
 
411
</para>
 
412
 
 
413
@date1: 
 
414
@date2: 
 
415
 
 
416
 
 
417
<!-- ##### FUNCTION g_date_get_day ##### -->
 
418
<para>
 
419
 
 
420
</para>
 
421
 
 
422
@date: 
 
423
@Returns: 
 
424
 
 
425
 
 
426
<!-- ##### FUNCTION g_date_get_month ##### -->
 
427
<para>
 
428
 
 
429
</para>
 
430
 
 
431
@date: 
 
432
@Returns: 
 
433
 
 
434
 
 
435
<!-- ##### FUNCTION g_date_get_year ##### -->
 
436
<para>
 
437
 
 
438
</para>
 
439
 
 
440
@date: 
 
441
@Returns: 
 
442
 
 
443
 
 
444
<!-- ##### FUNCTION g_date_get_julian ##### -->
 
445
<para>
 
446
 
 
447
</para>
 
448
 
 
449
@date: 
 
450
@Returns: 
 
451
 
 
452
 
 
453
<!-- ##### FUNCTION g_date_get_weekday ##### -->
 
454
<para>
 
455
 
 
456
</para>
 
457
 
 
458
@date: 
 
459
@Returns: 
 
460
 
 
461
 
 
462
<!-- ##### FUNCTION g_date_get_day_of_year ##### -->
 
463
<para>
 
464
 
 
465
</para>
 
466
 
 
467
@date: 
 
468
@Returns: 
 
469
 
 
470
 
 
471
<!-- ##### FUNCTION g_date_get_days_in_month ##### -->
 
472
<para>
 
473
 
 
474
</para>
 
475
 
 
476
@month: 
 
477
@year: 
 
478
@Returns: 
 
479
 
 
480
 
 
481
<!-- ##### FUNCTION g_date_is_first_of_month ##### -->
 
482
<para>
 
483
 
 
484
</para>
 
485
 
 
486
@date: 
 
487
@Returns: 
 
488
 
 
489
 
 
490
<!-- ##### FUNCTION g_date_is_last_of_month ##### -->
 
491
<para>
 
492
 
 
493
</para>
 
494
 
 
495
@date: 
 
496
@Returns: 
 
497
 
 
498
 
 
499
<!-- ##### FUNCTION g_date_is_leap_year ##### -->
 
500
<para>
 
501
 
 
502
</para>
 
503
 
 
504
@year: 
 
505
@Returns: 
 
506
 
 
507
 
 
508
<!-- ##### FUNCTION g_date_get_monday_week_of_year ##### -->
 
509
<para>
 
510
 
 
511
</para>
 
512
 
 
513
@date: 
 
514
@Returns: 
 
515
 
 
516
 
 
517
<!-- ##### FUNCTION g_date_get_monday_weeks_in_year ##### -->
 
518
<para>
 
519
 
 
520
</para>
 
521
 
 
522
@year: 
 
523
@Returns: 
 
524
 
 
525
 
 
526
<!-- ##### FUNCTION g_date_get_sunday_week_of_year ##### -->
 
527
<para>
 
528
 
 
529
</para>
 
530
 
 
531
@date: 
 
532
@Returns: 
 
533
 
 
534
 
 
535
<!-- ##### FUNCTION g_date_get_sunday_weeks_in_year ##### -->
 
536
<para>
 
537
 
 
538
</para>
 
539
 
 
540
@year: 
 
541
@Returns: 
 
542
 
 
543
 
 
544
<!-- ##### FUNCTION g_date_get_iso8601_week_of_year ##### -->
 
545
<para>
 
546
 
 
547
</para>
 
548
 
 
549
@date: 
 
550
@Returns: 
 
551
 
 
552
 
 
553
<!-- ##### FUNCTION g_date_strftime ##### -->
 
554
<para>
 
555
 
 
556
</para>
 
557
 
 
558
@s: 
 
559
@slen: 
 
560
@format: 
 
561
@date: 
 
562
@Returns: 
 
563
 
 
564
 
 
565
<!-- ##### FUNCTION g_date_to_struct_tm ##### -->
 
566
<para>
 
567
 
 
568
</para>
 
569
 
 
570
@date: 
 
571
@tm: 
 
572
 
 
573
 
 
574
<!-- ##### FUNCTION g_date_valid ##### -->
 
575
<para>
 
576
 
 
577
</para>
 
578
 
 
579
@date: 
 
580
@Returns: 
 
581
 
 
582
 
 
583
<!-- ##### FUNCTION g_date_valid_day ##### -->
 
584
<para>
 
585
 
 
586
</para>
 
587
 
 
588
@day: 
 
589
@Returns: 
 
590
 
 
591
 
 
592
<!-- ##### FUNCTION g_date_valid_month ##### -->
 
593
<para>
 
594
 
 
595
</para>
 
596
 
 
597
@month: 
 
598
@Returns: 
 
599
 
 
600
 
 
601
<!-- ##### FUNCTION g_date_valid_year ##### -->
 
602
<para>
 
603
 
 
604
</para>
 
605
 
 
606
@year: 
 
607
@Returns: 
 
608
 
 
609
 
 
610
<!-- ##### FUNCTION g_date_valid_dmy ##### -->
 
611
<para>
 
612
 
 
613
</para>
 
614
 
 
615
@day: 
 
616
@month: 
 
617
@year: 
 
618
@Returns: 
 
619
 
 
620
 
 
621
<!-- ##### FUNCTION g_date_valid_julian ##### -->
 
622
<para>
 
623
 
 
624
</para>
 
625
 
 
626
@julian_date: 
 
627
@Returns: 
 
628
 
 
629
 
 
630
<!-- ##### FUNCTION g_date_valid_weekday ##### -->
 
631
<para>
 
632
 
 
633
</para>
 
634
 
 
635
@weekday: 
 
636
@Returns: 
 
637
 
 
638