annotate docs/modules/txt/TimeUtil.txt @ 0:4816e4a8ae95 draft default tip

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 09:23:18 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
1 NAME
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
2 TimeUtil
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
3
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
4 SYNOPSIS
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
5 use TimeUtil;
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
6
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
7 use TimeUtil qw(:all);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
8
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
9 DESCRIPTION
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
10 TimeUtil module provides the following functions:
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
11
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
12 CTimeStamp, FPFileTimeStamp, ISO8601Date, ISO8601Time, ISO8601TimeStamp,
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
13 MonthNameToNumber, MonthNumberToAbbreviatedName, MonthNumberToFullName,
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
14 PDBFileTimeStamp, SDFileTimeStamp, TimeStamp, WeekDayNameToNumber,
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
15 WeekDayNumberToAbbreviatedName, WeekDayNumberToFullName
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
16
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
17 FUNCTIONS
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
18 CTimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
19 $CTimeStamp = CTimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
20
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
21 Returns CTimeStamp string using the following format: WDay Mon MDay
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
22 HH:MM:SS YYYY
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
23
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
24 FPFileTimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
25 $FPFileTimeStamp = FPFileTimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
26
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
27 Returns fingerints FP file time stamp string for MayaChemTools
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
28 package. It corresponds to CTimeStamp.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
29
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
30 ISO8601Date
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
31 $Date = ISO8601Date();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
32
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
33 Returns ISO8601 Date string using the following format:
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
34 [YYYY]-[MM]-[DD]
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
35
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
36 ISO8601Time
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
37 $Time = ISO8601Time();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
38
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
39 Returns ISO8601 Time string using the following extended format:
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
40 [hh]:[mm]:[ss]
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
41
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
42 ISO8601TimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
43 $TimeStamp = ISO8601TimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
44
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
45 Returns ISO8601 TimeStamp string using the following extended
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
46 format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
47
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
48 MonthNameToNumber
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
49 $Number = MonthNameToNumber($Name);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
50
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
51 Return month Number for full month *Name* or three letter
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
52 abbreviated month *Name*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
53
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
54 MonthNumberToAbbreviatedName
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
55 $AbbrevMonthName = MonthNumberToAbbreviatedName($Number);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
56
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
57 Returns three letter AbbrevMonthName for month *Number*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
58
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
59 MonthNumberToFullName
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
60 $Name = MonthNumberToFullName($Number);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
61
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
62 Returns full month Name for month *Number*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
63
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
64 PDBFileTimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
65 $TimeStamp = PDBFileTimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
66
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
67 Returns PDB file TimeStamp using the following format: DD-MMM-YY
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
68
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
69 SDFileTimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
70 $TimeStamp = SDFileTimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
71
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
72 Returns SD file TimeStamp using the following format: MMDDYYHHMM
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
73
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
74 TimeStamp
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
75 $TimeStamp = TimeStamp();
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
76
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
77 Returns deafult *TimeStamp* for MayaChemTools. It corresponds to
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
78 CTimeStamp.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
79
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
80 WeekDayNameToNumber
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
81 $Number = WeekDayNameToNumber($Name);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
82
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
83 Returns week day Number from full week day *Name* or three letter
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
84 abbreviated week day *Name*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
85
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
86 WeekDayNumberToAbbreviatedName
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
87 $Name = WeekDayNumberToAbbreviatedName($Number);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
88
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
89 Returns three letter abbreviates week day Name for week day
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
90 *Number*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
91
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
92 WeekDayNumberToFullName
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
93 $Name = WeekDayNumberToFullName($Number);
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
94
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
95 Returns full week day Name for week day *Number*.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
96
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
97 AUTHOR
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
98 Manish Sud <msud@san.rr.com>
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
99
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
100 SEE ALSO
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
101 FileUtil.pm, TextUtil.pm
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
102
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
103 COPYRIGHT
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
104 Copyright (C) 2015 Manish Sud. All rights reserved.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
105
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
106 This file is part of MayaChemTools.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
107
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
108 MayaChemTools is free software; you can redistribute it and/or modify it
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
109 under the terms of the GNU Lesser General Public License as published by
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
110 the Free Software Foundation; either version 3 of the License, or (at
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
111 your option) any later version.
4816e4a8ae95 Uploaded
deepakjadmin
parents:
diff changeset
112