Time and Date Identifiers

$asctime(N,format)

Returns the time and date in text format associated with the $ctime time value.

$asctime(793947600)

returns the default text format for this time value

$asctime(hh:nn:ss)

returns the current time in this format

$asctime(793947600,dd/mm/yy)

returns the date for this time value

The identifiers $time(), $date(), and $gmt() can also be used with the format specification below.

The format parameter is optional, if it isn't provided, a default format is used. The format can be a combination of the following items:

Note: You can specify both the N and format parameters, or only one or the other.

$ctime

Returns total number of seconds elapsed since 00:00:00 GMT, January 1, 1970 based on your system time.

$ctime(text)

Returns the number of seconds elapsed since 00:00:00 GMT, January 1, 1970 based on the date that you specify.

$ctime(January 1 1970 00:00:00)

$ctime(3rd August 1987 3:46pm)

$ctime(21/4/72 1:30:37)

$ctime(Wed 1998-3-27 21:16)

$ctimer

Returns name of timer that triggered the current script.

$date

Returns the current date in day/month/year format.

For the date in US format you can use $adate.

$day

Returns the name of the current day ie. Monday, Tuesday, etc.

$daylight

Returns seconds offset if daylight savings is in effect, and 0 if not.

$duration(seconds,N)

Returns the specified number of seconds in a week/day/hour/minute/second format.

The N parameter is optional. If N = 2, the result does not include the seconds value. If N = 3, the result is in h:m:s format.

Note: This identifier can also take its own output and change it back into seconds.

$fulldate

Returns the current date in the format: Wed Jun 26 21:41:02 1996

$gmt

Returns the current GMT time value in $ctime format.

$idle

Returns your current idle time (same time as that returned by a ctcp finger).

$logstamp

Returns the current time based on the logging timestamp format as defined in the logging dialog.

$logstampfmt

Returns the logging timestamp format as defined in the logging dialog.

$ltimer

Returns the number of the last timer that was started by the /timer command.

$online

Returns the number of seconds elapsed in the Timer dialog.

$ticks

Returns the number of ticks since your operating system was first started.

$time

Returns the current time in hour:minute:second format.

$timer(N/name)

Returns the timer id of the Nth timer in the timers list. You can also specify a timer name instead of a number. This identifier works in conjunction with the /timer command.

Properties: com, time, reps, delay, type, secs, mmt, anysc, wid, cid, hwnd

$timer(0)

returns the number of active timers

$timer(1)

returns the timer id of the 1st timer in the list

$timer(1).com

returns the command for the 1st timer in the list

$timer(3).type

returns online/offline status for the 3rd timer in the list

$timer(3).secs

returns number of seconds left before timer is triggered

$timer(3).mmt

returns $true if timer is a multimedia timer

$timer(3).anysc

returns $true if the /timer -i switch was specified

$timestamp

Returns the current time based on the event timestamp format as defined in the message dialog.

$timestampfmt

Returns the event timestamp format as defined in the message dialog.

$timezone

This returns your current timezone setting in seconds.

$uptime(mirc | server | system, N)

Returns uptime in milliseconds for specified item.

N is optional, N = 1 returns same format as $duration(), N = 2 returns same format as $duration() but without seconds, and N = 3 returns seconds instead of milliseconds.