Semiconductor & Computer Engineering
From WikiChip
Difference between revisions of "mirc/identifiers/$gmt"
Maroonbells (talk | contribs) |
Maroonbells (talk | contribs) |
||
| Line 1: | Line 1: | ||
| − | {{mirc title|$gmt Identifier}}'''$gmt''' return the current GMT time value in {{mIRC|$ctime}} format. $gmt also accept optional time and/or format parameters, displaying the same format as {{mIRC|$asctime}}, adjusted by $timezone. | + | {{mirc title|$gmt Identifier}}'''$gmt''' return the current GMT time value in {{mIRC|$ctime}} format. $gmt also accept optional time and/or format parameters, displaying the same format as {{mIRC|$asctime}}, adjusted by $timezone/$daylight settings. |
| − | |||
== Synopsis == | == Synopsis == | ||
<pre>$gmt | <pre>$gmt | ||
$gmt(date [,format])</pre> | $gmt(date [,format])</pre> | ||
| − | == | + | == Parameters == |
| − | '''no parameters''' Returns ctime adjusted by the $timezone value | + | * '''no parameters''' Returns ctime adjusted by the $timezone value |
| − | '''date''' Optional ctime | + | * '''date''' Optional ctime number, overrides the default ctime. Returns the GMT time string in $asctime format. Ignores any fractions. |
| − | '''format''' Optional format letters same as for {{mIRC|$asctime}} | + | * '''format''' Optional format letters same as for {{mIRC|$asctime}} |
== Properties == | == Properties == | ||
None | None | ||
| Line 15: | Line 14: | ||
<source lang="mIRC"> | <source lang="mIRC"> | ||
//echo -a $gmt($ctime) is the same as $asctime($calc($ctime + $timezone ) ) | //echo -a $gmt($ctime) is the same as $asctime($calc($ctime + $timezone ) ) | ||
| − | //echo -a $gmt is same as $ctime + $timezone | + | //echo -a $gmt is same as $calc( $ctime + $timezone ) |
| − | //echo -a $gmt($ | + | //echo -a Current GMT is $gmt($ctime, ddd dd mmmm yyyy hh:nn:sstt) |
</source> | </source> | ||
| + | * Beginning v7.56, changes made to $gmt are: | ||
| + | 1. The z|zz|zzz format strings now return the string for GMT zone instead of the user's zone.<br/> | ||
| + | 2. Fixed bug where $gmt(number) handled all dates as if they were during the same $daylight zone as the current date, resulting in different output for $gmt(0), for most people, when script is run in January vs June. | ||
| + | <source lang="mIRC"> | ||
| + | //echo -a $gmt($calc(0+$iif($version isnum 7.56-,0,$daylight))) is Thu Jan 01 00:00:00 1970 | ||
| + | </source> | ||
| + | 3. New API recognizes larger date range. N can now be numbers which resolve to 1 second after midnight at the beginning of year 1601, through 1 second prior midnight at the end of the last day of year 9999. Returns $null of N is outside that range. | ||
| + | <source lang="mIRC"> | ||
| + | //echo -a $gmt($calc(0-86400*365.25*369+86400*3.25+1))) is Mon Jan 01 00:00:01 1601 | ||
| + | //echo -a $gmt($calc(0+86400*365.25*(9999-1970)+86400*304.75-1))) is Fri Dec 31 23:59:59 9999 | ||
| + | valid range is -11644473599 through +253402300799 | ||
| + | </source> | ||
== Compatibility == | == Compatibility == | ||
{{mIRC compatibility|5.5}} | {{mIRC compatibility|5.5}} | ||
| − | |||
== See Also == | == See Also == | ||
{{collist | {{collist | ||
Latest revision as of 15:32, 6 July 2019
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
$gmt return the current GMT time value in $ctime format. $gmt also accept optional time and/or format parameters, displaying the same format as $asctime, adjusted by $timezone/$daylight settings.
Synopsis[edit]
$gmt $gmt(date [,format])
Parameters[edit]
- no parameters Returns ctime adjusted by the $timezone value
- date Optional ctime number, overrides the default ctime. Returns the GMT time string in $asctime format. Ignores any fractions.
- format Optional format letters same as for $asctime
Properties[edit]
None
Example[edit]
//echo -a $gmt($ctime) is the same as $asctime($calc($ctime + $timezone ) ) //echo -a $gmt is same as $calc( $ctime + $timezone ) //echo -a Current GMT is $gmt($ctime, ddd dd mmmm yyyy hh:nn:sstt)
- Beginning v7.56, changes made to $gmt are:
1. The z|zz|zzz format strings now return the string for GMT zone instead of the user's zone.
2. Fixed bug where $gmt(number) handled all dates as if they were during the same $daylight zone as the current date, resulting in different output for $gmt(0), for most people, when script is run in January vs June.
//echo -a $gmt($calc(0+$iif($version isnum 7.56-,0,$daylight))) is Thu Jan 01 00:00:00 1970
3. New API recognizes larger date range. N can now be numbers which resolve to 1 second after midnight at the beginning of year 1601, through 1 second prior midnight at the end of the last day of year 9999. Returns $null of N is outside that range.
//echo -a $gmt($calc(0-86400*365.25*369+86400*3.25+1))) is Mon Jan 01 00:00:01 1601 //echo -a $gmt($calc(0+86400*365.25*(9999-1970)+86400*304.75-1))) is Fri Dec 31 23:59:59 9999 valid range is -11644473599 through +253402300799
Compatibility[edit]
Added: mIRC v5.5
Added on: 08 Jan 1999
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.