Finding out the current model time
You can get current model (logical) time using the function
time(). There are two notations: the simple one,
returns the current model time as number of model time units simulated since the model start. Another,
returns the number of specified time units simulated so far. For example,
returns the number of simulated minutes (a double value).
Finding out the current date, day of week, hour of day, etc.
The date in AnyLogic is stored in the form of the Java class
Date. Date is composed of the year, month, day of month, hour of the day, minute, second, and millisecond. To find out the current date, you should call the function
A number of functions return particular components of the current date (and all those functions also have the form without a parameter, in which case they return the component of a given, not current, date):
int getYear(Date date)
– returns the year of the current date.
int getMonth(Date date)
– returns the month of the current date: one of the constants
int getDayOfMonth(Date date)
– returns the day of the month of the current date: 1, 2, …
int getDayOfWeek(Date date)
– returns the day of the week of the current date: one of the constants
SUNDAY, MONDAY, …
int getHourOfDay(Date date)
– returns the hour of the day of the current date in 24-hour format: for 10:20 PM, will return 22.
int getHour(Date date)
– returns the hour of the day of the current date in 12-hour format: for 10:20 PM, will return 10.
int getAmPm(Date date)
– returns the constant AM if the current date is before noon, and PM otherwise.
int getMinute(Date date)
– returns the minute within the hour of the current date.
int getSecond(Date date)
– returns the second within the minute of the current date.
Functions to make model independent of time unit settings
Let’s say the time unit in your model is hours. What if you need to schedule something to happen in 2 days? Or how would you define a duration of 5 minutes? Of course, you could write 48 and 5.0/60. But a much better solution is to use the special
functions that return the value of a given time interval with respect to the current time unit settings:
– returns the value of a one-millisecond time interval.
– returns the value of a one-second time interval.
– returns the value of a one-minute time interval.
– returns the value of a one-hour time interval.
– returns the value of a one-day time interval.
– returns the value of a one-week time interval.
For example, if the time unit is hours,
will return 0.0166, and
will return 168.0. Thus, instead of remembering what the current time unit is and writing 48 or 5./60, you can simply write
5*minute(). You can also combine different units in one expression:
3 * hour() 20 * minute().
What is probably even more important about these functions is that the expressions using them are completely independent of the time unit settings: the expressions always evaluate to the correct time intervals. Therefore, we recommend always using
multipliers such as
day(), etc. in the numeric expressions that represent time intervals: this way, you can freely change the time units without changing the model.
double addToDate(Date date, int timeUnit, double amount)
– Returns the date, which will be after the given amount of given time units from the given
addToDate( DAY, 1 )
returns the 'tomorrow' date: (
1 day )
– Converts the given date to model time with respect to the start date, start time and model time unit settings.
time unit constant, double time1, double time2 )
– Returns the difference (time2 - time1) between two model dates (corresponding to the given model times) in the given time units. Result is the number of date units that should be added to the model time
time2. The result may be negative and may have fractional part depending on the given dates.
Date dropTime(Date date)
– Drops time-of-the-day information and returns the same date but with the time being set to 00:00:00.000
Date timeToDate(double t)
– Converts the given model time to date with respect to the start date, start time and model time unit settings,
if the time is infinity.
Date toDate(int year,
– Returns the date in the default time zone, constructed from the given components (year, month, day, etc.).
long toDateInMillis(int year,
– Returns the date in the default time zone, constructed from the given components (year, month, day, etc.). Same as
toDate(int, int, int, int, int, int)
but returns the date as the number of milliseconds since January 1, 1970, 00:00:00 GMT.
double toModelTime(double value,
time unit constant)
– Converts the timeout (given as the number of specified time units) to the model time units. You define the timeout using the function arguments: first, you pass the value as the
argument, and then specify the time units using the second argument,
units. For example, the model time units in your model are minutes. In this case the function call
will return 195/60 = 3.25
double toTimeoutInCalendar(time unit constant, double amount)– Returns timeout in model time units, which equals to the given
of specified time units from current model date, e.g.
toTimeoutInCalendar( DAY, 1 )
returns timeout in model time units from
double toTimeUnits( double modelTimeValue,
time unit constant
)– Converts the timeout (specified as the number of model time units) to the specified time units. For example, the model time units are minutes. In this case the function call
will return 5.5*60 = 330.