comparison trunk/src/dil/Time.d @ 798:c24be8d4f6ab

Added documentation comments.
author Aziz K?ksal <aziz.koeksal@gmail.com>
date Sat, 01 Mar 2008 02:53:06 +0100
parents 580d4ca9f1ff
children
comparison
equal deleted inserted replaced
797:cf2ad5df025c 798:c24be8d4f6ab
5 module dil.Time; 5 module dil.Time;
6 6
7 import tango.stdc.time : time_t, time, ctime; 7 import tango.stdc.time : time_t, time, ctime;
8 import tango.stdc.string : strlen; 8 import tango.stdc.string : strlen;
9 9
10 /// Some convenience functions for dealing with C's time functions.
10 struct Time 11 struct Time
11 { 12 {
12 static: 13 static:
14 /// Returns the current date as a string.
13 char[] toString() 15 char[] toString()
14 { 16 {
15 time_t time_val; 17 time_t time_val;
16 .time(&time_val); 18 .time(&time_val);
17 char* str = ctime(&time_val); // ctime returns a pointer to a static array. 19 char* str = ctime(&time_val); // ctime returns a pointer to a static array.
18 char[] timeStr = str[0 .. strlen(str)-1]; // -1 removes trailing '\n'. 20 char[] timeStr = str[0 .. strlen(str)-1]; // -1 removes trailing '\n'.
19 return timeStr.dup; 21 return timeStr.dup;
20 } 22 }
21 23
24 /// Returns the time of timeStr: hh:mm:ss
22 char[] time(char[] timeStr) 25 char[] time(char[] timeStr)
23 { 26 {
24 return timeStr[11..19]; 27 return timeStr[11..19];
25 } 28 }
26 29
30 /// Returns the month and day of timeStr: Mmm dd
27 char[] month_day(char[] timeStr) 31 char[] month_day(char[] timeStr)
28 { 32 {
29 return timeStr[4..10]; 33 return timeStr[4..10];
30 } 34 }
31 35
36 /// Returns the year of timeStr: yyyy
32 char[] year(char[] timeStr) 37 char[] year(char[] timeStr)
33 { 38 {
34 return timeStr[20..24]; 39 return timeStr[20..24];
35 } 40 }
36 } 41 }