Class DATETIME

Name

DATETIME  --  Класс предназначен для управления датами и временем.

Synopsis

 DateTimeNew([<nYear>,[<nMonth>,[<nDay>,[<nHour>[,<nMin>[,<nSec>[,<nMsec>]]]]]]]) --> DATETIME object

Description

Класс предназначен для управления датами и временем.

Attributes

<ClassName> DATETIME
<Data> Date, дата
  

Methods

ADD Сложить два объекта DATETIME.
DATE Получить дату.
DATETIMENEW Конструктор объекта DATETIME.
DAY Получить значение "день"
HOUR Получить значение "часы"
MIN Получить значение "минуты"
MONTH Получить значение "месяц"
MSEC Получить значение "миллисекунды"
NORMALIZE Нормализовать объект DATETIME.
SEC Получить значение "секунды"
SUB Вычесть из объекта DATETIME другой.
TIME Получить строку в формате "время".
YEAR Получить значение "год"

Method DATETIME:ADD()

 Add(<oDt>) 	--> <oDateTime>

Add() добавляет <oDt> к содержимому объекта DATETIME и возвращает последний. Полученный объект содержит не нормализованное значение даты.

Method DATETIME:DATE()

 Date() 	--> <dData>

Date() преобразует DATETIME атрибут <::Data> в нормализованную календарную дату и возвращает полученное значение типа дата.

Method DATETIME:DATETIMENEW()

 DateTimeNew([<nYear>,[<nMonth>,[<nDay>,[<nHour>[,<nMin>[,<nSec>[,<nMsec>]]]]]]]) --> DATETIME object

DateTimeNew() создает и возвращает объект DATETIME. Объект этого класса может быть использован для создания, управления данными типа дата и время.

Если параметры не переданы, объект создастся с нулевой датой.

Внимаение! Объект содержит не нормализованную дату.

Method DATETIME:DAY()

 Day() 	--> <nDay>

Day() возвращает числовое значение: день, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:HOUR()

 Hour() 	--> <nHour>

Hour() возвращает числовое значение: часы, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:MIN()

 Min() 	--> <nMin>

Min() возвращает числовое значение: минуты, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:MONTH()

 Month() 	--> <nMonth>

Month() возвращает числовое значение: месяц, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:MSEC()

 Msec() 	--> <nMsec>

Msec() возвращает числовое значение: миллисекунды, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:NORMALIZE()

 Normalize() 	--> <oDateTime>

Normalize() преобразует DATETIME <::Data> в нормальную календарную дату и возвращает преобразованный объект.

Method DATETIME:SEC()

 Sec() 	--> <nSec>

Sec() возвращает числовое значение: секунды, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Method DATETIME:SUB()

 Sub(<oDt>) 	--> <oDateTime>

Sub() вычитает <oDt> из содержимого объекта DATETIME и возвращает последний. Полученный объект содержит не нормализованное значение даты.

Method DATETIME:TIME()

 Time() 	--> <sTime>

Time() возвращает нормализованное значение времени, определенное в <::Data> объекта DATETIME, в виде строки формата <hh:mm:ss:ms> или возвращает "00:00:00:00" , если DATETIME объект содержит нулевую дату. Где <hh> двухзначное значение час, <mm> - двухзначное згачение минуты, <ss> двухзначное значение секундыи <ms> двухзначное значение миллисекунды.

Method DATETIME:YEAR()

 Year() 	--> <nYear>

Year() возвращает числовое значение (4 цифры): год, определенное в <::Data> объекта DATETIME. Возвращаемое значение не нормализовано.

Example:

 /* Create */
 dt := DateTimeNew(2003, 01, 01) //
 ? dt:Year()	// --> 2003
 ? dt:Month()	// --> 01
 ? dt:Day()	// --> 01
 
 dt := DateTimeNew()
 ? dt:Year()	// --> 0
 ? dt:Month()	// --> 0
 ? dt:Day()	// --> 0
 ? dt:Date()     // --> 02-12-0001
 
 dt := DateTimeNew(2000)
 ? dt:Year()	// --> 2000
 ? dt:Month()	// --> 0
 ? dt:Day()	// --> 0
 ? dt:Date()     // --> 30-11-1999
 
 
 
 /* Normalize */
 dt := DateTimeNew(2003, 03, 41)
 ? dt:Day()		// --> 41
 ? dt:Normalize()	// --> DateTime object
 ? dt:Day()		// --> 10
 ? dt:Date()		// --> 10-04-2003
 
 dt := DateTimeNew(0, 0, 0)
 ? dt:Year()		// --> 0
 ? dt:Month()		// --> 0
 ? dt:Day()		// --> 0
 ? dt:Normalize()	// --> DateTime object
 
 ? dt:Year()		// --> 0001
 ? dt:Month()		// --> 12
 ? dt:Day()		// --> 02
 ? dt:Date()		// --> 02-12-0001
 
 /* Control */
 dt := DateTimeNew(2003, 03, 01)
 ? dt:Year()	// --> 2003
 ? dt:Month()	// --> 03
 ? dt:Day()	// --> 01
 dt2 := DateTimeNew(0, 0, 54)
 
 dt:Add(dt2)
 ? dt:Year()	// --> 2003
 ? dt:Month()	// --> 03
 ? dt:Day()	// --> 55
 ? dt:Date()	// --> 24-04-2003
 
 
 dt := DateTimeNew(2003, 03, 01)
 ? dt:Year()	// --> 2003
 ? dt:Month()	// --> 03
 ? dt:Day()	// --> 01
 dt2 := DateTimeNew(0, 0, 54)
 
 dt:Sub(dt2)
 ? dt:Year()	// --> 2003
 ? dt:Month()	// --> 03
 ? dt:Day()	// --> -53
 ? dt:Date()	// --> 06-01-2003
 

Platforms

No dependies of platform.