m |
Maroonbells (talk | contribs) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
− | {{mirc title|$gmt Identifier}}'''$gmt''' return the current GMT time value in {{mIRC|$ctime}} format. $gmt also accept | + | {{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> | |
− | + | == Parameters == | |
− | + | * '''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 {{mIRC|$asctime}} | |
− | |||
− | |||
== Properties == | == Properties == | ||
− | |||
None | None | ||
== Example == | == Example == | ||
− | <source lang="mIRC">//echo -a $gmt</source> | + | <source lang="mIRC"> |
+ | //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) | ||
+ | </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 == | ||
− | {{mIRC|$ | + | {{collist |
− | {{mIRC|$date}} | + | |count = 3 |
− | {{mIRC|$fulldate}} | + | |style = width: 60%; display: inherit; |
− | {{mIRC|$ | + | | |
− | {{mIRC|$ | + | * {{mIRC|$asctime}} |
− | {{mIRC|$ | + | * {{mIRC|$date}} |
− | {{mIRC|$duration}} | + | * {{mIRC|$adate}} |
− | + | * {{mIRC|$time}} | |
− | + | * {{mIRC|$ctime}} | |
+ | * {{mIRC|$fulldate}} | ||
+ | * {{mIRC|$ticks}} | ||
+ | * {{mIRC|$day}} | ||
+ | * {{mIRC|$daylight}} | ||
+ | * {{mIRC|$timezone}} | ||
+ | * {{mIRC|$duration}} | ||
+ | * {{mIRC|$uptime}} | ||
+ | }} |
Latest revision as of 15:32, 6 July 2019
$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.