Modifying the solution time zone

You can modify or set the solution time zone. Edit the solution manifest file and add a specific header to specify the time zone for the solution.

About this task

Events are required to have a time stamp. If an event that is coming into the solution from an external server does not include a time stamp, the event submission time is used as the time stamp. In this case, the event time stamp is aligned with the solution time zone. The solution time zone is also used to define the time zone of a time point that is specified by a date or simple date value, in rules or aggregates.

By default, the time zone of the solution is the time zone of the server on which the solution is deployed. If you want to specify a different time zone than the time zone of the server, you can add time zone information to the manifest file of the solution project. In the SOLUTION.MF manifest file, add the IBM-IA-ZoneId header and the solution ZoneId value to specify a time zone for the solution, for example, IBM-IA-ZoneId: UTC+01.

There are three types of time zone identifiers: ZoneOffset, ZoneOffset with a zone prefix, and region-based, as described in the following table.
Table 1. Time zone identifier description and examples
Identifier type Description Example
ZoneOffset Sets the time zone as greater than (+) or less (-) than Coordinated Universal Time (UTC) or Greenwich Mean Time (GMT) IBM-IA-ZoneId: Z+01
ZoneOffset with zone prefix Sets the time zone relative to a reference time zone represented by a prefix: GMT, UTC, or Universal Time (UT) IBM-IA-ZoneId: UTC+01
Region-based Sets the time zone by using a region-based ID as defined by the Internet Assigned Numbers Authority (IANA) Time Zone Database (TZDB)

IBM-IA-ZoneId: America/New_York
IBM-IA-ZoneId: Europe/Paris

Procedure

  1. Edit the solution manifest file. The SOLUTION.MF file is in the root directory of the solution project.
  2. Add the IBM-IA-ZoneID header and the ZoneId value to the file, as shown in this example:
    Manifest-Version: 1.0
    IBM-IA-SolutionName: OilServiceSolution
    IBM-IA-SolutionVersion: 0.72
    IBM-IA-ZoneId: America/New_York
    where America/New York is a region-based zone identifier.