From WikiChip
Difference between revisions of "mirc/identifiers/$gmt"
< mirc‎ | identifiers

m
 
(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 a parameter, a date of the same format as {{mIRC|$asctime}}.
+
{{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>
+
<pre>$gmt
<pre>$gmt(<date>)</pre>
+
$gmt(date [,format])</pre>
 
+
== Parameters ==
 
+
* '''no parameters''' Returns ctime adjusted by the $timezone value
== Paramters ==
+
* '''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}}
<span style="display: inline-block; width: 50px;">'''date'''</span>A date respecting the same format supported by {{mIRC|$asctime}}, returns the corresponding GMT time from that date.
 
 
 
 
== 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|$ticks}}
+
{{collist
{{mIRC|$date}}
+
|count = 3
{{mIRC|$fulldate}}
+
|style = width: 60%; display: inherit;
{{mIRC|$time}}
+
|
{{mIRC|$timezone}}
+
* {{mIRC|$asctime}}
{{mIRC|$asctime}}
+
* {{mIRC|$date}}
{{mIRC|$duration}}
+
* {{mIRC|$adate}}
 
+
* {{mIRC|$time}}
[[Category:mIRC identifiers|gmt]]
+
* {{mIRC|$ctime}}
 +
* {{mIRC|$fulldate}}
 +
* {{mIRC|$ticks}}
 +
* {{mIRC|$day}}
 +
* {{mIRC|$daylight}}
 +
* {{mIRC|$timezone}}
 +
* {{mIRC|$duration}}
 +
* {{mIRC|$uptime}}
 +
}}

Latest revision as of 16: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.

See Also[edit]