DatePicker

DatePicker主要供用户选择日期。

支持的XML属性

DatePicker的共有XML属性继承自:StackLayout

DatePicker的自有XML属性见下表:

属性名称 中文描述 取值 取值说明 使用案例
date_order 显示格式,年月日 0 表示日期以日-月-年的格式显示。 ohos:date_order="0"
1 表示日期以月-日-年的格式显示。
2 表示日期以年-月-日的格式显示。
3 表示日期以年-日-月的格式显示。
4 表示日期以日-月的格式显示。
5 表示日期以月-日的格式显示。
6 表示日期以年-月的格式显示。
7 表示日期以月-年的格式显示。
8 表示只显示年份。
9 表示只显示月份。
10 表示只显示日期。
day_fixed 日期是否固定 boolean类型 可以直接设置true/false,也可以引用boolean资源。 ohos:day_fixed="true"ohos:day_fixed="$boolean:true"
month_fixed 月份是否固定 boolean类型 可以直接设置true/false,也可以引用boolean资源。 ohos:month_fixed="true"ohos:month_fixed="$boolean:true"
year_fixed 年份是否固定 boolean类型 可以直接设置true/false,也可以引用boolean资源。 ohos:year_fixed="true"ohos:year_fixed="$boolean:true"
max_date 最大日期 long类型 可以直接设置长整型值,也可以引用string资源。 ohos:time="1234567"ohos:time="$string:date"
min_date 最小日期 long类型 可以直接设置长整型值,也可以引用string资源。 ohos:time="1234567"ohos:time="$string:date"
text_size 文本大小 float类型 表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。 ohos:text_size="30"ohos:text_size="16fp"ohos:text_size="$float:size_value"
normal_text_size 取消选中文本的大小 float类型 表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。 ohos:normal_text_size="30"ohos:normal_text_size="16fp"ohos:normal_text_size="$float:size_value"
selected_text_size 选中文本的大小 float类型 表示尺寸的float类型。可以是浮点数值,其默认单位为px;也可以是带px/vp/fp单位的浮点数值;也可以引用float资源。 ohos:selected_text_size="30"ohos:selected_text_size="16fp"ohos:selected_text_size="$float:size_value"
normal_text_color 取消选中文本的颜色 color类型 可以直接设置色值,也可以引用color资源。 ohos:normal_text_color="#A8FFFFFF"ohos:normal_text_color="$color:black"
selected_text_color 选中文本的颜色 color类型 可以直接设置色值,也可以引用color资源。 ohos:selected_text_color="#A8FFFFFF"ohos:selected_text_color="$color:black"
operated_text_color 操作项的文本颜色 color类型 可以直接设置色值,也可以引用color资源。 ohos:operated_text_color="#A8FFFFFF"ohos:operated_text_color="$color:black"
selected_normal_text_margin_ratio 已选文本边距与正常文本边距的比例 float类型 可以直接设置浮点数值,也可以引用float浮点数资源。取值需>0.0f,默认值为1.0f。 ohos:selected_normal_text_margin_ratio="0.5"ohos:selected_normal_text_margin_ratio="$float:ratio"
selector_item_num 显示的项数 integer类型 可以直接设置整型数值,也可以引用integer资源。 ohos:selector_item_num="10"ohos:selector_item_num="$integer:num"
shader_color 着色器颜色 color类型 可以直接设置色值,也可以引用color资源。 ohos:shader_color="#A8FFFFFF"ohos:shader_color="$color:black"
top_line_element 选中项的顶行 Element类型 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 ohos:top_line_element="#FFFFFFFF"ohos:top_line_element="$color:black"ohos:top_line_element="$media:media_src"ohos:top_line_element="$graphic:graphic_src"
bottom_line_element 选中项的底线 Element类型 可直接配置色值,也可引用color资源或引用media/graphic下的图片资源。 ohos:bottom_line_element="#FFFFFFFF"ohos:bottom_line_element="$color:black"ohos:bottom_line_element="$media:media_src"ohos:bottom_line_element="$graphic:graphic_src"
wheel_mode_enabled 选择轮是否绕行 boolean类型 可以直接设置true/false,也可以引用boolean资源。 ohos:wheel_mode_enabled="true"ohos:wheel_mode_enabled="$boolean:true"

使用DatePicker

  • 在XML中创建DatePicker

    <DatePicker    ohos:id="$+id:date_pick"    ohos:height="match_content"    ohos:width="300vp"></DatePicker>
    

    图1 创建默认的DatePicker img

  • 获取当前选择日期,日/月/年,DatePicker默认选择当前日期。

    // 获取DatePicker实例DatePicker datePicker = (DatePicker) findComponentById(ResourceTable.Id_date_pick);int day = datePicker.getDayOfMonth();int month = datePicker.getMonth();int year = datePicker.getYear();
    
  • 响应日期改变事件:

    在XML中添加Text显示选择日期:

    <Text    ohos:id="$+id:text_date"    ohos:height="match_content"    ohos:width="match_parent"    ohos:hint="date"    ohos:margin="8vp"    ohos:padding="4vp"    ohos:text_size="14fp"></Text>
    

    在Java代码中响应日期改变事件:

    Text selectedDate = (Text) findComponentById(ResourceTable.Id_text_date);datePicker.setValueChangedListener(        new DatePicker.ValueChangedListener() {            @Override            public void onValueChanged(DatePicker datePicker, int year, int monthOfYear, int dayOfMonth) {                selectedDate.setText(String.format("%02d/%02d/%4d", dayOfMonth, monthOfYear, year));            }        });
    

    图2 日期改变响应效果 img

  • 设置当前日期

    datePicker.updateDate(2021, 8, 8);
    
  • 设置日期的范围

    如需对DatePicker的日期选择范围有要求,可以设置属性min_date和max_date。设置的值为日期对应的Unix时间戳

    1. 设置最小日期

      在xml设置:

      <DatePicker    ...    ohos:min_date="1627747200"></DatePicker>
      

      在代码中设置:

      datePicker.setMinDate(1627747200);
      

      图3 设置最小日期为2021/08/01 img

    2. 设置最大日期

      在XML中设置:

      <DatePicker    ...    ohos:max_date="1630339200"></DatePicker>
      

      在代码中设置:

      datePicker.setMaxDate(1630339200);
      

      图4 设置最大日期为2021/08/31 img

  • 固定年/月/日

    在XML中设置:

    <DatePicker    ...    ohos:year_fixed="true"></DatePicker>
    

    在代码中设置:

    datePicker.setYearFixed(true);
    

样式设置

  • 文本相关属性

    1. 设置待选项的字体大小和颜色

      <DatePicker    ...    ohos:normal_text_color="#00FFFF"    ohos:normal_text_size="20fp"></DatePicker>
      

      图5 设置待选项的字体大小和颜色效果 img

    2. 设置已选项的字体大小和颜色

      在XML中设置:

      <DatePicker    ...    ohos:selected_text_color="#00FFFF"    ohos:selected_text_size="20fp"></DatePicker>
      

      在代码中设置:

      datePicker.setSelectedTextSize(40);datePicker.setSelectedTextColor(new Color(Color.getIntColor("#FFA500")));
      

      图6 设置已选项的字体大小和颜色效果 img

    3. 设置操作项的字体颜色

      在XML中设置:

      <DatePicker    ...    ohos:operated_text_color="#00FFFF"></DatePicker>
      

      在代码中设置:

      datePicker.setOperatedTextColor(new Color(Color.getIntColor("#00FFFF")));
      

      图7 设置操作项的字体颜色效果 img

  • 设置DatePicker中所选文本边距与普通文本边距的比例

    在XML中设置:

    <DatePicker    ...    ohos:selected_normal_text_margin_ratio="10"></DatePicker>
    

    在代码中设置:

    datePicker.setSelectedNormalTextMarginRatio(10.0f)
    

    图8 已选文本边距与正常文本边距比例设置为10 img

  • 设置滚轮绕行

    在XML中设置:

    <DatePicker    ...    ohos:wheel_mode_enabled="true"></DatePicker>
    

    在代码中设置:

    datePicker.setWheelModeEnabled(true);
    

    图9 滚轮绕行效果 img

  • 设置选中日期的上下边框

    在XML中设置:

    <DatePicker    ...    ohos:top_line_element="#9370DB"    ohos:bottom_line_element="#9370DB"></DatePicker>
    

    在代码中设置:

    ShapeElement shape = new ShapeElement();shape.setShape(ShapeElement.RECTANGLE);shape.setRgbColor(RgbColor.fromArgbInt(0xFF9370DB));datePicker.setDisplayedLinesElements(shape,shape);
    

    图10 添加选中项上下边框效果 img

  • 设置着色器颜色

    在XML中设置:

    <DatePicker    ...    ohos:shader_color="gray"></DatePicker>
    

    在代码中设置:

    datePicker.setShaderColor(new Color(Color.getIntColor("#00CED1")));
    

    图11 设置着色器颜色效果 img

results matching ""

    No results matching ""