22 Date（日期）

作者：老葛，北京亚艾元软件有限责任公司，http://www.yaiyuan.com

    日期元素，它是一个由3个下拉选择框联合而成的元素。如果没有提供默认值，#default_value则默认为今天的日期。#default_value和#return_value的格式是一个包含三个元素的关联数组，对应的键为：'year'、month'、'day'。例如：

array('year' => 2011, 'month' => 7, 'day' => 26)

示例代码，来自(profile.module):

$fields[$category][$field->name] = array(
  '#type' => 'date', 
  '#title' => check_plain($field->title), 
  '#default_value' => $edit[$field->name], 
  '#description' => _profile_form_explanation($field), 
  '#required' => $field->required
);

    Date元素默认的显示顺序是“月，日，年”，对于中文用户来说，这个顺序不是很习惯，要把它改为“年，月，日”，只需要在“admin/config/regional/date-time”页面，简单的配置一下默认的日期格式就可以了，将其设置为中文用户习惯的日期格式，比如“Y/m/d H:i”。

常用属性: #access、 #after_build、 #attributes、 #default_value、 #description、 #disabled、 #element_validate、 #parents、 #post_render、 #prefix、 #pre_render、 #process、 #required、 #states、 #suffix、 #theme、 #theme_wrappers、 #title、 #title_display、 #tree、 #type、 #weight。

    属性#process默认设为form_process_date ()，在该方法中年选择器被硬编码为从1900到2050。属性#element_validate默认设为date_validate()（两个函数都位于includes/form.inc中）。当你在表单中定义日期元素时，通过定义这两个属性,就可以使用你自己的代码来替代默认设置了。