Starttime

starttime - Simulation start time

Synopsis

clock {
  starttime '2000-01-01 00:00:00 UTC';
}

#set starttime='2000-01-01 00:00:00 UTC'

host% gridlabd --define starttime='2000-01-01 00:00:00 UTC' modelfile.glm
host% gridlabd -Dstarttime='2000-01-01 00:00:00 UTC' modelfile.glm

Description

The starttime global variable determine the time at which the simulation begins. Until the clock is set to the starttime after the initialization is completed the clock is set to INIT. Before the first iteration begins, the clock will be set to starttime.

As of Hassayampa (Version 3.0)

The default starttime is '2000-01-01 00:00:00' in the local timezone.

GLM

The start time is usually set using the clock directive as follows:

 clock {
   timezone PST8PDT;
   starttime '2000-01-01 00:00:00 PST';
   stoptime '2001-01-01 00:00:00 PST';
 }

The start time can also be set using the #set macro directive:

#set starttime='2000-01-01 00:00:00 UTC'

Command line

The start time can be set using the command line:

host% gridlabd --define starttime='2001-01-01 00:00:00 PST'

or

host% gridlabd -Dstarttime='2001-01-01 00:00:00 PST'

Bugs

If the starttime includes a timezone specification, then the local time zone must be specified. If the timezone is not set (e.g., using the TZ environment variable), the command line or model parser may be unable to interpret the timestamp and an error may occur.

See also

• Clock
  • Global variable
  • GLM directive
    • starttime
    • stoptime
    • timezone
• Time zones
  • TZ
  • tzinfo.txt
• Technical manuals
  • Local time (DATETIME C Module API)
  • Global time (TIMESTAMP Built-in type)
  • Time class (gld_clock C++ Module API)