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 is not provided, a default format is used. The format can be a combination of the following items:

 

Year

 

Month

 

 

 

Day

 

 

 

Hours

 

 

 

Minutes

 

Seconds

 

AM/PM

 

 

 

Ordinal

Timezone

yy

yyyy

m

mm

mmm

mmmm

d

dd

ddd

dddd

h

hh

H

HH

n

nn

s

ss

t

tt

T

TT

oo

z

zz

zzz

99

1999

1

01

Jan

January

1

01

Mon

Monday

5

05

13

13

1

01

1

01

a/p

am/pm

A/P

AM/PM

st/nd/rd/th

+0

+0000

+0000 GMT

 

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 hh:nn:ss 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 timer id of the last timer that was started by the /timer command.

 

$online / $onlineserver / $onlinetotal

Returns the number of seconds elapsed in the Online Timer dialog.

 

$ticks

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

 

$ticksqpc

Returns the number of ticks since your operating system was first started using a high resolution tick counter.

 

$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, pause, name

 

$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

 

Note: The name property treats the specified parameter as a timer name (in case the name is a number) and returns the timer N position.

 

$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.