Class DateTime

DateTime-class represents a date with time.

Constructors

Methods

Example

main
  DateTime now = system.get current DateTime
  print "Now is the year: " & now.get year

See Also

System

(datetime) copy

Creates a copy of source.

Example

main
  DateTime now = system.get current datetime
  DateTime past = now.copy                      // past == now

(datetime) new datetime day <int d> month <int m> year <int y> [ hours <int h = 0> ] [ minutes <int mi = 0> ] [ seconds <int s = 0> ] [ timezone <timezone tz = LOCAL> ]

Constructs a DateTime with given parameters.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8

add [ <int d = 0> days ] [ <int h = 0> hours ] [ <int m = 0> minutes ] [ <int s = 0> seconds ]

Add given amount of time to existing DateTime.

Parameters

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // date will be "08.05.2009 10:38:00 local timezone"
  date.add 10 days 30 minutes

subtract [ <int d = 0> days ] [ <int h = 0> hours ] [ <int m = 0> minutes ] [ <int s = 0> seconds ]

Subtract given amount of time of existing DateTime.

Parameters

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // date will be "18.04.2009 09:38:00 local timezone"
  date.subtract 10 days 30 minutes

(int) get day

Returns the day.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int day = date.get day                                                    // day == 28

(int) get month

Returns the month.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int month = date.get month                                                    // month == 4

(int) get year

Returns the year.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int year = date.get year                                                    // year == 2008

(int) get hour

Returns hours.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int hour = date.get hour                                                    // hour == 10

(int) get minute

Returns minutes.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int minutes = date.get minute                                                    // minutes == 8

(int) get second

Returns seconds.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  int seconds = date.get second                                                    // second == 0

(timezone) get timezone

Returns timezone.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  TimeZone tz = date.get timezone                                           // timezone == LOCAL

set day to <int d>

Set the day.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 10.04.2009 10:08:00 local timezone
  date.set day to 10

set month to <int m>

Set the month.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.10.2009 10:08:00 local timezone
  date.set month to 10

set year to <int y>

Set the year.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.04.2012 10:08:00 local timezone
  date.set year to 2012

set hour to <int h>

Set hours.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.04.2009 15:08:00 local timezone
  date.set hour to 15

set minute to <int m>

Set minutes.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.04.2009 10:59:00 local timezone
  date.set minute to 59

set second to <int s>

Set seconds.

Parameters

Exceptions

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.04.2009 10:08:12 local timezone
  date.set second to 12

set timezone to <timezone tz>

Set timezone.

Parameters

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  // 28.04.2009 10:08:00 UTC timezone
  date.set timezone to UTC

(string) as string

Return DateTime as string.

Return value

Example

main
  // 28.04.2009 10:08:00 local timezone
  DateTime date = new datetime day 28 month 4 year 2009 hours 10 minutes 8
  print date.as string      // LOG: 2009-04-28 10:08:00