symfony API

DateFormHelper Functions

You are currently browsing
the website for symfony 1

Visit the Symfony2 website


« Back to API menu

1.1 API OpenSearch

Packages

You are currently browsing the symfony API for the 1.1 version. Switch to:
This version of symfony is not maintained anymore.
If some of your projects still use this version, consider upgrading as soon as possible.

DateFormHelper.

Function Summary

  • string select_ampm_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with AM and PM options for use with 12-Hour time.
  • string select_datetime_tag($name, $value, $options, $html_options)
    Returns a variable number of <select> tags populated with date and time related select boxes.
  • string select_date_tag($name, $value, $options, $html_options)
    Returns three <select> tags populated with a range of months, days, and years.
  • string select_day_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with all the days of the month (1 - 31).
  • string select_hour_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with 24 hours (0 - 23), or optionally 12 hours (1 - 12).
  • string select_minute_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with 60 minutes (0 - 59).
  • string select_month_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with all the months of the year (1 - 12).
  • string select_number_tag($name, $value, $options, $html_options)
    Returns a <select> tag, populated with a range of numbers
  • string select_second_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with 60 seconds (0 - 59).
  • string select_timezone_tag($name, $selected, $options)
    Returns a <select> tag populated with all the timezones in the world.
  • string select_time_tag($name, $value, $options, $html_options)
    Returns three <select> tags populated with hours, minutes, and optionally seconds.
  • string select_year_tag($name, $value, $options, $html_options)
    Returns a <select> tag populated with a range of years.
  • string _get_I18n_date_locales($culture)
    Retrieves the proper date format based on the specified <i>$culture</i> setting
  • string _parse_value_for_date($value, $key, $format_char)
    Converts date values (<i>$value</i>) into its correct date format (<i>$format_char</i>)

Function Details

  • (string) select_ampm_tag ($name, $value, $options, $html_options) Browse code

    $name field name
    $value selected value (AM or PM)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    echo select_ampm_tag('ampm', 'PM', array('include_blank' => true));

    returns

    $name field name (automatically becomes an array of date and time parts)
    $value accepts a valid time string or properly formatted time array
    $options special options for the select tagss
    $html_options additional HTML compliant

    Returns a variable number of <select> 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


    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));

    returns a variable number of

    $name field name (automatically becomes an array of parts: name[year], name[month], year[day])
    $value accepts a valid date string or properly formatted date array
    $options special options for the select tags
    $html_options additional HTML compliant

    Returns three <select> 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


    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));

    returns three

    $name field name
    $value selected value (1 - 31)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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

    Examples:

    echo select_day_tag('day', 14);

    returns

    $name field name
    $value selected value (0 - 23 or 1 - 12 if '12hour_time' = true)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    echo select_hour_tag('hour', 6, array('12hour_time' => true));

    returns

    $name field name
    $value selected value (0 - 59)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    echo select_minute_tag('minute', 15, array('minute_step' => 15));

    returns

    $name field name
    $value selected value (1 - 12)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    echo select_month_tag('month', null, array('use_month_numbers' => true, 'include_blank' => true));

    returns

    $name field name
    $value the selected option
    $options special options for the select tagss
    $html_options additional HTML compliant

    Returns a <select> 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

    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));

    returns

    $name field name
    $value selected value (0 - 59)
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    echo select_second_tag('second', 15, array('second_step' => 15));

    returns

    $name field name
    $selected selected field value (timezone identifier)
    $options additional HTML compliant

    Returns a <select> 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

    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)



    Examples:

    echo select_timezone_tag('timezone', 'America/Denver');

    returns

    $name field name (automatically becomes an array of parts: name[hour], name[minute], year[second])
    $value accepts a valid time string or properly formatted time array
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns three <select> 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


    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));

    returns three

    $name field name
    $value selected value within the range of years.
    $options special options for the select tag
    $html_options additional HTML compliant

    Returns a <select> 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


    $year_start = date('Y', strtotime('-10 years'));
    $year_end = date('Y', strtotime('+10 years'));
    echo select_year_tag('year', null, array('year_start' => $year_start, 'year_end' => $year_end));

    returns

    $culture two or three character culture setting variable

    Retrieves the proper date format based on the specified <i>$culture</i> setting


    Note: If no $culture is defined, the user's culture setting will be used in its place.

    returns formatted date/time format based on the specified date/time setting

  • (string) _parse_value_for_date ($value, $key, $format_char) Browse code

    $value date or date part
    $key custom key for array values
    $format_char date format

    Converts date values (<i>$value</i>) into its correct date format (<i>$format_char</i>)


    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.

    returns properly formatted date part value.