date/help/date-api.html

   1 <p>
   2 Once the Date API is installed, all functions in the API are available to be used
   3 anywhere by any module. If the Date Timezone module is installed, the system site
   4 timezone selector and the user timezone selectors are overwritten to allow the
   5 selection of timezone names instead of offsets. Proper timezone conversion
   6 requires knowledge of those timezone names, something that is not currently
   7 available in Drupal core, and the change in selectors makes it possible to track it.
   8 </p>
   9 <p>
  10 In most cases, you should enable the Date Timezone module any time you use the
  11 Date API to be able to set the site and user timezone names. It is not enabled by
  12 default in case another module is setting timezone names in the database.
  13 </p>
  14 <p>
  15 The API uses the PHP 5.2 date functions to create and manipulate dates, and
  16 contains an option module that will emulate those functions in earlier versions
  17 of PHP.
  18 </p>
  19 <p>
  20 If you are using PHP 4 or PHP 5.0 or 5.1, native date handling won't work right.
  21 Install the Date_PHP4 module to enable wrapper functions so this code will work
  22 in old PHP versions.
  23 </p>