public function MigrateDateFieldHandler::prepare in Migrate Extras 6.2

Convert incoming data into the proper field arrays for Date fields.

Parameters

$entity: The destination entity which will hold the field arrays.

array $field_info: Metadata for the date field being populated.

array $instance: Metadata for this instance of the date field being populated.

array $values: Array of date values to be fielded.

File

./date.inc, line 39

Support for migration into Date fields.

Class

MigrateDateFieldHandler

@file Support for migration into Date fields.

Code

public function prepare($entity, array $instance, array $values) {
  if (isset($values['arguments'])) {
    $arguments = $values['arguments'];
    unset($values['arguments']);
  }
  else {
    $arguments = array();
  }
  if (isset($arguments['timezone'])) {
    $default_timezone = $arguments['timezone'];
  }
  else {
    $default_timezone = 'UTC';
  }
  if (isset($arguments['timezone_db'])) {
    $default_timezone_db = $arguments['timezone_db'];
  }
  else {
    $default_timezone_db = NULL;
  }
  if (isset($arguments['rrule'])) {
    $default_rrule = $arguments['rrule'];
  }
  else {
    $default_rrule = NULL;
  }

  // Convert the timezone name to an offset
  $date = date_now($default_timezone);
  $default_timezone = date_offset_get($date);

  // Setup the standard Field API array for saving.
  $delta = 0;
  foreach ($values as $from) {

    // Set defaults
    $to = NULL;
    $timezone = $default_timezone;
    $timezone_db = $default_timezone_db;
    $rrule = $default_rrule;

    // Is the value a straight datetime value, or JSON containing a set of properties?
    if (!empty($from) && $from[0] == '{') {
      $properties = json_decode($from, TRUE);
      $from = $properties['from'];

      // Properties passed in with the date override any set via arguments
      if (!empty($properties['to'])) {
        $to = $properties['to'];
      }
      if (!empty($properties['timezone'])) {
        $date = date_now($properties['timezone']);
        $timezone = date_offset_get($date);
      }
      if (!empty($properties['timezone_db'])) {
        $timezone_db = $properties['timezone_db'];
      }
      if (!empty($properties['rrule'])) {
        $rrule = $properties['rrule'];
      }
    }

    // Work from a timestamp
    $from = MigrationBase::timestamp($from);
    if ($to) {
      $to = MigrationBase::timestamp($to);
    }

    // What does the destination field expect?
    switch ($instance['type']) {
      case 'datestamp':

        // Already done
        break;
      case 'datetime':

        // YYYY-MM-DD HH:MM:SS
        $from = format_date($from, 'custom', 'Y-m-d H:i', $timezone);
        if ($to) {
          $to = format_date($to, 'custom', 'Y-m-d H:i', $timezone);
        }
        break;
      case 'date':

        // ISO date: YYYY-MM-DDTHH:MM:SS
        $from = format_date($from, 'custom', 'Y-m-d\\TH:i', $timezone);
        if ($to) {
          $to = format_date($to, 'custom', 'Y-m-d\\TH:i', $timezone);
        }
        break;
      default:
        break;
    }

    // Handle repeats, coming in as RRULEs. Many field instances may be created.
    if ($instance['widget']['type'] == 'date_text_repeat' && $rrule) {
      include_once drupal_get_path('module', 'date') . '/date_repeat.inc';
      include_once drupal_get_path('module', 'date_api') . '/date_api_ical.inc';
      $item = array(
        'value' => $from,
        'value2' => $to,
        'timezone' => $timezone,
      );

      // Can be de-uglified when http://drupal.org/node/1159404 is committed.
      $return = date_repeat_build_dates(NULL, date_ical_parse_rrule($instance, $rrule), $instance, $item);
    }
    else {
      $return[$delta]['value'] = $from;
      if (!empty($to)) {
        $return[$delta]['value2'] = $to;
      }
    }
    $delta++;
  }
  if (!isset($return)) {
    $return = NULL;
  }
  return $return;
}