* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ /** * DateFormHelper. * * @package symfony * @subpackage helper * @author Fabien Potencier * @version SVN: $Id: DateFormHelper.php 3294 2007-01-16 06:53:15Z fabien $ */ /** * Returns a tag populated with all the days of the month (1 - 31). * * By default, the $value parameter is set to today's day. To override this, simply pass an integer * (1 - 31) to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. For convenience, symfony also offers the select_date_tag helper function which combines the * select_year_tag, select_month_tag, and select_day_tag functions into a single helper. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * * Examples: * * echo submit_day_tag('day', 14); * * * @param string field name * @param integer selected value (1 - 31) * @param array additional HTML compliant tag parameters * @return string tag populated with all the days of the month (1 - 31). * @see select_date_tag, select datetime_tag */ function select_day_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('j'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); for ($x = 1; $x < 32; $x++) { $select_options[$x] = str_pad($x, 2, '0', STR_PAD_LEFT); } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns a tag populated with all the months of the year (1 - 12). * * By default, the $value parameter is set to today's month. To override this, simply pass an integer * (1 - 12) to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. Also, the each month's display title is set to return its respective full month name, which can be easily * overridden by passing the 'use_short_names' or 'use_month_numbers' options to the $options parameter. * For convenience, Symfony also offers the select_date_tag helper function which combines the * select_year_tag, select_month_tag, and select_day_tag functions into a single helper. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value * - use_month_numbers - If set to true, will show the month's numerical value (1 - 12) instead of the months full name. * - use_short_month - If set to true, will show the month's short name (i.e. Jan, Feb, Mar) instead of its full name. * * Examples: * * echo submit_month_tag('month', 5, array('use_short_month' => true)); * * * * echo submit_month_tag('month', null, array('use_month_numbers' => true, 'include_blank' => true)); * * * @param string field name * @param integer selected value (1 - 12) * @param array additional HTML compliant tag parameters * @return string tag populated with all the months of the year (1 - 12). * @see select_date_tag, select datetime_tag */ function select_month_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('n'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); if (_get_option($options, 'use_month_numbers')) { for ($k = 1; $k < 13; $k++) { $select_options[$k] = str_pad($k, 2, '0', STR_PAD_LEFT); } } else { $culture = _get_option($options, 'culture', sfContext::getInstance()->getUser()->getCulture()); $I18n_arr = _get_I18n_date_locales($culture); if (_get_option($options, 'use_short_month')) { $month_names = $I18n_arr['dateFormatInfo']->getAbbreviatedMonthNames(); } else { $month_names = $I18n_arr['dateFormatInfo']->getMonthNames(); } $add_month_numbers = _get_option($options, 'add_month_numbers'); foreach ($month_names as $k => $v) { $select_options[$k + 1] = $add_month_numbers ? ($k + 1).' - '.$v : $v; } } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns a tag populated with a range of years. * * By default, the $value parameter is set to today's year. To override this, simply pass a four-digit integer (YYYY) * to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. Also, the default selectable range of years is set to show five years back and five years forward from today's year. * For instance, if today's year is 2006, the default 'year_start' option will be set to 2001 and the 'year_end' option will be set * to 2011. These start and end dates can easily be overwritten by setting the 'year_start' and 'year_end' options in the $options * parameter. For convenience, Symfony also offers the select_date_tag helper function which combines the * select_year_tag, select_month_tag, and select_day_tag functions into a single helper. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value * - year_start - If set, the range of years will begin at this four-digit date (i.e. 1979) * - year_end - If set, the range of years will end at this four-digit date (i.e. 2025) * * Examples: * * echo submit_year_tag('year'); * * * * $year_start = date('Y', strtotime('-10 years')); * $year_end = date('Y', strtotime('+10 years')); * echo submit_year_tag('year', null, array('year_start' => $year_start, 'year_end' => $year_end)); * * * @param string field name * @param integer selected value within the range of years. * @param array additional HTML compliant tag parameters * @return string tag populated with a range of years. * @see select_date_tag, select datetime_tag */ function select_year_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('Y'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); if (strlen($value) > 0 && is_numeric($value)) { $year_origin = $value; } else { $year_origin = date('Y'); } $year_start = _get_option($options, 'year_start', $year_origin - 5); $year_end = _get_option($options, 'year_end', $year_origin + 5); $ascending = ($year_start < $year_end); $until_year = ($ascending) ? $year_end + 1 : $year_end - 1; for ($x = $year_start; $x != $until_year; ($ascending) ? $x++ : $x--) { $select_options[$x] = $x; } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns three tags populated with a range of months, days, and years. * * By default, the $value parameter is set to today's month, day and year. To override this, simply pass a valid date * or a correctly formatted date array (see example) to the $value parameter. You can also set the $value * parameter to null which will disable the $value, however this will only be useful if you pass 'include_blank' or * 'include_custom' to the $options parameter. Also, the default selectable range of years is set to show five years * back and five years forward from today's year. For instance, if today's year is 2006, the default 'year_start' option will * be set to 2001 and the 'year_end' option will be set to 2011. These start and end dates can easily be overwritten by * setting the 'year_start' and 'year_end' options in the $options parameter. * * Note: The $name parameter will automatically converted to array names. For example, a $name of "date" becomes: * * ... * ... * ... * * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - discard_month - If set to true, will only return select tags for day and year. * - discard_day - If set to true, will only return select tags for month and year. * - discard_year - If set to true, will only return select tags for month and day. * - use_month_numbers - If set to true, will show the month's numerical value (1 - 12) instead of the months full name. * - use_short_month - If set to true, will show the month's short name (i.e. Jan, Feb, Mar) instead of its full name. * - year_start - If set, the range of years will begin at this four-digit date (i.e. 1979) * - year_end - If set, the range of years will end at this four-digit date (i.e. 2025) * - date_seperator - Includes a string of defined text between each generated select tag * * Examples: * * echo submit_date_tag('date'); * * * * echo select_date_tag('date', '2006-10-30'); * * * * $date = array('year' => '1979', 'month' => 10, 'day' => 30); * echo select_date_tag('date', $date, array('year_start' => $date['year'] - 10, 'year_end' => $date['year'] + 10)); * * * @param string field name (automatically becomes an array of parts: name[year], name[month], year[day]) * @param mixed accepts a valid date string or properly formatted date array * @param array additional HTML compliant tag parameters * @return string three tags populated with a months, days and years * @see select datetime_tag, select_month_tag, select_date_tag, select_year_tag */ function select_date_tag($name, $value = null, $options = array(), $html_options = array()) { $options = _parse_attributes($options); $culture = _get_option($options, 'culture', sfContext::getInstance()->getUser()->getCulture()); // set it back for month tag $options['culture'] = $culture; $I18n_arr = _get_I18n_date_locales($culture); $date_seperator = _get_option($options, 'date_seperator', $I18n_arr['date_seperator']); $discard_month = _get_option($options, 'discard_month'); $discard_day = _get_option($options, 'discard_day'); $discard_year = _get_option($options, 'discard_year'); // discarding month automatically discards day if ($discard_month) { $discard_day = true; } $order = _get_option($options, 'order'); $tags = array(); if (is_array($order) && count($order) == 3) { foreach ($order as $v) { $tags[] = $v[0]; } } else { $tags = $I18n_arr['date_order']; } if ($include_custom = _get_option($options, 'include_custom')) { $include_custom_month = is_array($include_custom) ? (isset($include_custom['month']) ? array('include_custom' => $include_custom['month']) : array()) : array('include_custom' => $include_custom); $include_custom_day = is_array($include_custom) ? (isset($include_custom['day']) ? array('include_custom' => $include_custom['day']) : array()) : array('include_custom' => $include_custom); $include_custom_year = is_array($include_custom) ? (isset($include_custom['year']) ? array('include_custom' => $include_custom['year']) : array()) : array('include_custom' => $include_custom); } else { $include_custom_month = array(); $include_custom_day = array(); $include_custom_year = array(); } $month_name = $name.'[month]'; $m = !$discard_month ? select_month_tag($month_name, _parse_value_for_date($value, 'month', 'm'), $options + $include_custom_month, $html_options) : ''; $day_name = $name.'[day]'; $d = !$discard_day ? select_day_tag($day_name, _parse_value_for_date($value, 'day', 'd'), $options + $include_custom_day, $html_options) : ''; $year_name = $name.'[year]'; $y = !$discard_year ? select_year_tag($year_name, _parse_value_for_date($value, 'year', 'Y'), $options + $include_custom_year, $html_options) : ''; // we have $tags = array ('m','d','y') foreach ($tags as $k => $v) { // $tags['m|d|y'] = $m|$d|$y $tags[$k] = $$v; } return implode($date_seperator, $tags); } /** * Returns a tag populated with 60 seconds (0 - 59). * * By default, the $value parameter is set to the current second (right now). To override this, simply pass an integer * (0 - 59) to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. In many cases, you have no need for all 60 seconds in a minute. the 'second_step' option in the * $options parameter gives you the ability to define intervals to display. So for instance you could define 15 as your * 'minute_step' interval and the select tag would return the values 0, 15, 30, and 45. For convenience, Symfony also offers the * select_time_tag select_datetime_tag helper functions which combine other date and time helpers to easily build date and time select boxes. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - second_step - If set, the seconds will be incremented in blocks of X, where X = 'second_step' * * Examples: * * echo submit_second_tag('second'); * * * * echo submit_second_tag('second', 15, array('second_step' => 15)); * * * @param string field name * @param integer selected value (0 - 59) * @param array additional HTML compliant tag parameters * @return string tag populated with 60 seconds (0 - 59). * @see select_time_tag, select datetime_tag */ function select_second_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('s'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); $second_step = _get_option($options, 'second_step', 1); for ($x = 0; $x < 60; $x += $second_step) { $select_options[$x] = str_pad($x, 2, '0', STR_PAD_LEFT); } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns a tag populated with 60 minutes (0 - 59). * * By default, the $value parameter is set to the current minute. To override this, simply pass an integer * (0 - 59) to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. In many cases, you have no need for all 60 minutes in an hour. the 'minute_step' option in the * $options parameter gives you the ability to define intervals to display. So for instance you could define 15 as your * 'minute_step' interval and the select tag would return the values 0, 15, 30, and 45. For convenience, Symfony also offers the * select_time_tag select_datetime_tag helper functions which combine other date and time helpers to easily build date and time select boxes. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - minute_step - If set, the minutes will be incremented in blocks of X, where X = 'minute_step' * * Examples: * * echo submit_minute_tag('minute'); * * * * echo submit_minute_tag('minute', 15, array('minute_step' => 15)); * * * @param string field name * @param integer selected value (0 - 59) * @param array additional HTML compliant tag parameters * @return string tag populated with 60 minutes (0 - 59). * @see select_time_tag, select datetime_tag */ function select_minute_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('i'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); $minute_step = _get_option($options, 'minute_step', 1); for ($x = 0; $x < 60; $x += $minute_step) { $select_options[$x] = str_pad($x, 2, '0', STR_PAD_LEFT); } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns a tag populated with 24 hours (0 - 23), or optionally 12 hours (1 - 12). * * By default, the $value parameter is set to the current hour. To override this, simply pass an integer * (0 - 23 or 1 - 12 if '12hour_time' = true) to the $value parameter. You can also set the $value parameter to null which will disable * the $value, however this will only be useful if you pass 'include_blank' or 'include_custom' to the $options * parameter. For convenience, Symfony also offers the select_time_tag select_datetime_tag helper functions * which combine other date and time helpers to easily build date and time select boxes. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - 12hour_time - If set to true, will return integers 1 through 12 instead of the default 0 through 23 as well as an AM/PM select box. * * Examples: * * echo submit_hour_tag('hour'); * * * * echo submit_hour_tag('hour', 6, array('12hour_time' => true)); * * * @param string field name * @param integer selected value (0 - 23 or 1 - 12 if '12hour_time' = true) * @param array additional HTML compliant tag parameters * @return string tag populated with 24 hours (0 - 23), or optionally 12 hours (1 - 12). * @see select_time_tag, select datetime_tag */ function select_hour_tag($name, $value = null, $options = array(), $html_options = array()) { $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); $_12hour_time = _get_option($options, '12hour_time'); if ($value === null) { $value = date($_12hour_time ? 'h' : 'H'); } $start_hour = $_12hour_time ? 1 : 0; $end_hour = $_12hour_time ? 12 : 23; for ($x = $start_hour; $x <= $end_hour; $x++) { $select_options[$x] = str_pad($x, 2, '0', STR_PAD_LEFT); } return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns a tag populated with AM and PM options for use with 12-Hour time. * * By default, the $value parameter is set to the correct AM/PM setting based on the current time. * To override this, simply pass either AM or PM to the $value parameter. You can also set the * $value parameter to null which will disable the $value, however this will only be * useful if you pass 'include_blank' or 'include_custom' to the $options parameter. For * convenience, Symfony also offers the select_time_tag select_datetime_tag helper functions * which combine other date and time helpers to easily build date and time select boxes. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * * Examples: * * echo submit_ampm_tag('ampm'); * * * * echo submit_ampm_tag('ampm', 'PM', array('include_blank' => true)); * * * @param string field name * @param integer selected value (AM or PM) * @param array additional HTML compliant tag parameters * @return string tag populated with AM and PM options for use with 12-Hour time. * @see select_time_tag, select datetime_tag */ function select_ampm_tag($name, $value = null, $options = array(), $html_options = array()) { if ($value === null) { $value = date('A'); } $options = _parse_attributes($options); $select_options = array(); _convert_include_custom_for_select($options, $select_options); $select_options['AM'] = 'AM'; $select_options['PM'] = 'PM'; return select_tag($name, options_for_select($select_options, $value), $html_options); } /** * Returns three tags populated with hours, minutes, and optionally seconds. * * By default, the $value parameter is set to the current hour and minute. To override this, simply pass a valid time * or a correctly formatted time array (see example) to the $value parameter. You can also set the $value * parameter to null which will disable the $value, however this will only be useful if you pass 'include_blank' or * 'include_custom' to the $options parameter. To include seconds to the result, use set the 'include_second' option in the * $options parameter to true. Note: The $name parameter will automatically converted to array names. * For example, a $name of "time" becomes: * * ... * ... * ... * * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - include_second - If set to true, includes the "seconds" select tag as part of the result. * - second_step - If set, the seconds will be incremented in blocks of X, where X = 'second_step' * - minute_step - If set, the minutes will be incremented in blocks of X, where X = 'minute_step' * - 12hour_time - If set to true, will return integers 1 through 12 instead of the default 0 through 23 as well as an AM/PM select box. * - time_seperator - Includes a string of defined text between each generated select tag * - ampm_seperator - Includes a string of defined text between the minute/second select box and the AM/PM select box * * Examples: * * echo submit_time_tag('time'); * * * * echo select_time_tag('date', '09:31'); * * * * $time = array('hour' => '15', 'minute' => 46, 'second' => 01); * echo select_time_tag('time', $time, array('include_second' => true, '12hour_time' => true)); * * * @param string field name (automatically becomes an array of parts: name[hour], name[minute], year[second]) * @param mixed accepts a valid time string or properly formatted time array * @param array additional HTML compliant tag parameters * @return string three tags populated with a hours, minutes and optionally seconds. * @see select datetime_tag, select_hour_tag, select_minute_tag, select_second_tag */ function select_time_tag($name, $value = null, $options = array(), $html_options = array()) { $options = _parse_attributes($options); $time_seperator = _get_option($options, 'time_seperator', ':'); $ampm_seperator = _get_option($options, 'ampm_seperator', ''); $include_second = _get_option($options, 'include_second'); $_12hour_time = _get_option($options, '12hour_time'); $options['12hour_time'] = $_12hour_time; // set it back. hour tag needs it. if ($include_custom = _get_option($options, 'include_custom')) { $include_custom_hour = (is_array($include_custom)) ? ((isset($include_custom['hour'])) ? array('include_custom'=>$include_custom['hour']) : array()) : array('include_custom'=>$include_custom); $include_custom_minute = (is_array($include_custom)) ? ((isset($include_custom['minute'])) ? array('include_custom'=>$include_custom['minute']) : array()) : array('include_custom'=>$include_custom); $include_custom_second = (is_array($include_custom)) ? ((isset($include_custom['second'])) ? array('include_custom'=>$include_custom['second']) : array()) : array('include_custom'=>$include_custom); $include_custom_ampm = (is_array($include_custom)) ? ((isset($include_custom['ampm'])) ? array('include_custom'=>$include_custom['ampm']) : array()) : array('include_custom'=>$include_custom); } else { $include_custom_hour = array(); $include_custom_minute = array(); $include_custom_second = array(); $include_custom_ampm = array(); } $tags = array(); $hour_name = $name.'[hour]'; $tags[] = select_hour_tag($hour_name, _parse_value_for_date($value, 'hour', $_12hour_time ? 'h' : 'H'), $options + $include_custom_hour, $html_options); $minute_name = $name.'[minute]'; $tags[] = select_minute_tag($minute_name, _parse_value_for_date($value, 'minute', 'i'), $options + $include_custom_minute, $html_options); if ($include_second) { $second_name = $name.'[second]'; $tags[] = select_second_tag($second_name, _parse_value_for_date($value, 'second', 's'), $options + $include_custom_second, $html_options); } $time = implode($time_seperator, $tags); if ($_12hour_time) { $ampm_name = $name.'[ampm]'; $time .= $ampm_seperator.select_ampm_tag($ampm_name, _parse_value_for_date($value, 'ampm', 'A'), $options + $include_custom_ampm, $html_options); } return $time; } /** * Returns a variable number of tags populated with date and time related select boxes. * * The select_datetime_tag is the culmination of both the select_date_tag and the select_time_tag. * By default, the $value parameter is set to the current date and time. To override this, simply pass a valid * date, time, datetime string or correctly formatted array (see example) to the $value parameter. * You can also set the $value parameter to null which will disable the $value, however this * will only be useful if you pass 'include_blank' or 'include_custom' to the $options parameter. * To include seconds to the result, use set the 'include_second' option in the $options parameter to true. * Note: The $name parameter will automatically converted to array names. * For example, a $name of "datetime" becomes: * * ... * ... * ... * ... * ... * ... * * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - include_second - If set to true, includes the "seconds" select tag as part of the result. * - discard_month - If set to true, will only return select tags for day and year. * - discard_day - If set to true, will only return select tags for month and year. * - discard_year - If set to true, will only return select tags for month and day. * - use_month_numbers - If set to true, will show the month's numerical value (1 - 12) instead of the months full name. * - use_short_month - If set to true, will show the month's short name (i.e. Jan, Feb, Mar) instead of its full name. * - year_start - If set, the range of years will begin at this four-digit date (i.e. 1979) * - year_end - If set, the range of years will end at this four-digit date (i.e. 2025) * - second_step - If set, the seconds will be incremented in blocks of X, where X = 'second_step' * - minute_step - If set, the minutes will be incremented in blocks of X, where X = 'minute_step' * - 12hour_time - If set to true, will return integers 1 through 12 instead of the default 0 through 23. * - date_seperator - Includes a string of defined text between each generated select tag * - time_seperator - Includes a string of defined text between each generated select tag * - ampm_seperator - Includes a string of defined text between the minute/second select box and the AM/PM select box * * Examples: * * echo submit_datetime_tag('datetime'); * * * * echo select_datetime_tag('datetime', '1979-10-30'); * * * * $datetime = array('year' => '1979', 'month' => 10, 'day' => 30, 'hour' => '15', 'minute' => 46); * echo select_datetime_tag('time', $datetime, array('use_short_month' => true, '12hour_time' => true)); * * * @param string field name (automatically becomes an array of date and time parts) * @param mixed accepts a valid time string or properly formatted time array * @param array additional HTML compliant tag parameters * @return string a variable number of tags populated with date and time related select boxes * @see select date_tag, select_time_tag */ function select_datetime_tag($name, $value = null, $options = array(), $html_options = array()) { $options = _parse_attributes($options); $datetime_seperator = _get_option($options, 'datetime_seperator', ''); $date = select_date_tag($name, $value, $options, $html_options); $time = select_time_tag($name, $value, $options, $html_options); return $date.$datetime_seperator.$time; } /** * Returns a tag, populated with a range of numbers * * By default, the select_number_tag generates a list of numbers from 1 - 10, with an incremental value of 1. These values * can be easily changed by passing one or several $options. Numbers can be either positive or negative, integers or decimals, * and can be incremented by any number, decimal or integer. If you require the range of numbers to be listed in descending order, pass * the 'reverse' option to easily display the list of numbers in the opposite direction. * * Options: * - include_blank - Includes a blank tag at the beginning of the string with an empty value. * - include_custom - Includes an tag with a custom display title at the beginning of the string with an empty value. * - multiple - If set to true, the select tag will allow multiple numbers to be selected at once. * - start - The first number in the list. If not specified, the default value is 1. * - end - The last number in the list. If not specified, the default value is 10. * - increment - The number by which to increase each number in the list by until the number is greater than or equal to the 'end' option. * If not specified, the default value is 1. * - reverse - Reverses the order of numbers so they are display in descending order * * Examples: * * echo select_number_tag('rating', '', array('reverse' => true)); * * * * echo echo select_number_tag('tax_rate', '0.07', array('start' => '0.05', 'end' => '0.09', 'increment' => '0.01')); * * * * echo select_number_tag('limit', 5, array('start' => 5, 'end' => 120, 'increment' => 15)); * * * @param string field name * @param string the selected option * @param array $options to manipulate the output of the tag. * @param array additional HTML compliant tag parameters * @return string tag populated with a range of numbers. * @see options_for_select, content_tag */ function select_number_tag($name, $value, $options = array(), $html_options = array()) { $increment = _get_option($options, 'increment', 1); $range = array(); $max = _get_option($options, 'end', 10) + $increment; for ($x = _get_option($options, 'start', 1); $x < $max; $x += $increment) { $range[(string) $x] = $x; } if (_get_option($options, 'reverse')) { $range = array_reverse($range, true); } return select_tag($name, options_for_select($range, $value, $options), $html_options); } /** * Returns a tag populated with all the timezones in the world. * * The select_timezone_tag builds off the traditional select_tag function, and is conveniently populated with * all the timezones in the world (sorted alphabetically). Each option in the list has a unique timezone identifier * for its value and the timezone's locale as its display title. The timezone data is retrieved via the sfCultureInfo * class, which stores a wide variety of i18n and i10n settings for various countries and cultures throughout the world. * Here's an example of an tag generated by the select_timezone_tag: * * Options: * - display - * identifer - Display the PHP timezone identifier (e.g. America/Denver) * timezone - Display the full timezone name (e.g. Mountain Standard Time) * timezone_abbr - Display the timezone abbreviation (e.g. MST) * timzone_dst - Display the full timezone name with daylight savings time (e.g. Mountain Daylight Time) * timezone_dst_abbr - Display the timezone abbreviation with daylight savings time (e.g. MDT) * city - Display the city/region that relates to the timezone (e.g. Denver) * * * America/Denver * * * Examples: * * echo select_timezone_tag('timezone', 'America/Denver'); * * * @param string field name * @param string selected field value (timezone identifier) * @param array additional HTML compliant tag parameters * @return string tag populated with all the timezones in the world. * @see select_tag, options_for_select, sfCultureInfo */ function select_timezone_tag($name, $selected = null, $options = array()) { if (!isset($options['display'])) $options['display'] = 'identifier'; $c = new sfCultureInfo(sfContext::getInstance()->getUser()->getCulture()); $timezone_groups = $c->getTimeZones(); $display_key = 0; switch ($options['display']) { case "identifier": $display_key = 0; break; case "timezone": $display_key = 1; break; case "timezone_abbr": $display_key = 2; break; case "timezone_dst": $display_key = 3; break; case "timezone_dst_abbr": $display_key = 3; break; case "city": $display_key = 4; break; default: $display_key = 0; break; } unset($options['display']); $timezones = array(); foreach ($timezone_groups as $tz_group_key => $tz_group) { $array_key = null; foreach ($tz_group as $tz_key => $tz) { if ($tz_key == 0) $array_key = $tz; if ($tz_key == $display_key AND !empty($tz)) $timezones[$array_key] = $tz; } } // Remove duplicate values $timezones = array_unique($timezones); if ($timezone_option = _get_option($options, 'timezones')) { $diff = array_diff_key($timezones, array_flip((array) $timezone_option)); foreach ($diff as $key => $v) { unset($timezones[$key]); } } asort($timezones); $option_tags = options_for_select($timezones, $selected); return select_tag($name, $option_tags, $options); } /** * Converts date values ($value) into its correct date format ($format_char) * * This function is primarily used in select_date_tag, select_time_tag and select_datetime_tag. * * Note: If $value is empty, it will be populated with the current date and time. * * @param string date or date part * @param string custom key for array values * @return string properly formatted date part value. * @see select_date_tag, select_time_tag, select_datetime_tag */ function _parse_value_for_date($value, $key, $format_char) { if (is_array($value)) { return (isset($value[$key])) ? $value[$key] : ''; } else if (is_numeric($value)) { return date($format_char, $value); } else if ($value == '' || ($key == 'ampm' && ($value == 'AM' || $value == 'PM'))) { return $value; } else if (empty($value)) { $value = date('Y-m-d H:i:s'); } // english text presentation return date($format_char, strtotime($value)); } /** * Retrieves the proper date format based on the specified $culture setting * * Note: If no $culture is defined, the user's culture setting will be used in its place. * * @param string two or three character culture setting variable * @return string formatted date/time format based on the specified date/time setting * @see sfUser */ function _get_I18n_date_locales($culture = null) { if (!$culture) { $culture = sfContext::getInstance()->getUser()->getCulture(); } $retval = array('culture'=>$culture); $dateFormatInfo = sfDateTimeFormatInfo::getInstance($culture); $date_format = strtolower($dateFormatInfo->getShortDatePattern()); $retval['dateFormatInfo'] = $dateFormatInfo; $match_pattern = "/([dmy]+)(.*?)([dmy]+)(.*?)([dmy]+)/"; if (!preg_match($match_pattern, $date_format, $match_arr)) { // if matching fails use en shortdate preg_match($match_pattern, 'm/d/yy', $match_arr); } $retval['date_seperator'] = $match_arr[2]; // unset all but [dmy]+ unset($match_arr[0], $match_arr[2], $match_arr[4]); $retval['date_order'] = array(); foreach ($match_arr as $v) { // 'm/d/yy' => $retval[date_order] = array ('m', 'd', 'y'); $retval['date_order'][] = $v[0]; } return $retval; }