# @wines/date-picker-view

> The date-picker-view @wines

Latest version **2.0.0** (published 2025-04-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install @wines/date-picker-view
pnpm add @wines/date-picker-view
yarn add @wines/date-picker-view
bun add @wines/date-picker-view
```

## Health

**Score 30/100 (F)** — status: maintenance-mode.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2025-04-01 |
| First published | 2021-04-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=16.0.0 |
| Dependencies | 3 |
| Unpacked size | 57.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | tianyingchun |

## Links

- npm: https://www.npmjs.com/package/@wines/date-picker-view
- Repository: https://gitlab.itcjf.com/wines/date-picker-view
- npm.io page: https://npm.io/package/@wines/date-picker-view

## Dependencies (3)

- [@wines/core](https://npm.io/package/@wines/core.md) 2.0.0
- [@wines/picker-helpers](https://npm.io/package/@wines/picker-helpers.md) 2.0.0
- [@wines/picker-view-multi](https://npm.io/package/@wines/picker-view-multi.md) 2.0.0

## Recent versions

- 2.0.0 (latest) — 2025-04-01
- 2.0.0-next.7 (next) — 2025-04-01
- 2.0.0-next.6 — 2025-03-06
- 2.0.0-next.5 — 2025-03-05
- 2.0.0-next.4 — 2025-03-05
- 2.0.0-next.3 — 2025-03-04
- 2.0.0-next.2 — 2025-02-28
- 2.0.0-next.1 — 2025-02-27
- 2.0.0-next.0 — 2025-02-27
- 1.5.1 — 2023-03-07
- 1.5.0 — 2022-11-22
- 1.4.0 — 2022-02-23
- 1.3.5 — 2021-12-03
- 1.3.4 — 2021-09-26
- 1.3.2 — 2021-09-24
- … 2 more at https://npm.io/package/@wines/date-picker-view/versions

## README

# `@wines/date-picker-view`

# DatePickerView 日期选择器

嵌入页面的日期选择器。

## 使用指南

### 在 page.json 中引入组件

```json
{
  "navigationBarTitleText": "DatePickerView",
  "usingComponents": {
    "wux-segmented-control": "@wines/segmented-control",
    "wux-date-picker-view": "@wines/date-picker-view"
  }
}
```

### 示例

```xml
<view class="page">
	<view class="page__hd">
		<view class="page__title">DatePickerView</view>
		<view class="page__desc">日期选择器</view>
	</view>
	<view class="page__bd">
		<wux-segmented-control values="{{ ['zh_CN', 'zh_TW', 'en'] }}" bind:change="onChange" />
		<view class="sub-title">Default {{ displayValue1 }}</view>
		<wux-date-picker-view
		 lang="{{ lang }}"
		 value="{{ value1 }}"
		 data-index="1"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Mode = date {{ displayValue2 }}</view>
		<wux-date-picker-view
		 mode="date"
		 lang="{{ lang }}"
		 value="{{ value2 }}"
		 data-index="2"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Mode = year {{ displayValue3 }}</view>
		<wux-date-picker-view
		 mode="year"
		 lang="{{ lang }}"
		 value="{{ value3 }}"
		 data-index="3"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Mode = month {{ displayValue4 }}</view>
		<wux-date-picker-view
		 mode="month"
		 lang="{{ lang }}"
		 value="{{ value4 }}"
		 data-index="4"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Mode = time {{ displayValue5 }}</view>
		<wux-date-picker-view
		 mode="time"
		 lang="{{ lang }}"
		 value="{{ value5 }}"
		 data-index="5"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Use12Hours & datetime {{ displayValue6 }}</view>
		<wux-date-picker-view
		 use12Hours
		 mode="datetime"
		 lang="{{ lang }}"
		 value="{{ value6 }}"
		 data-index="6"
		 bind:valueChange="onValueChange"
		/>
		<view class="sub-title">Use12Hours & time {{ displayValue7 }}</view>
		<wux-date-picker-view
		 use12Hours
		 mode="time"
		 lang="{{ lang }}"
		 value="{{ value7 }}"
		 data-index="7"
		 bind:valueChange="onValueChange"
		/>
	</view>
</view>


```

```ts
import './index.less';
import { DatePickerViewGetValue } from '@wines/date-picker-view';

function getDateString(date = new Date()) {
  return {
    year: String(date.getFullYear()),
    month: String(date.getMonth()),
    day: String(date.getDate()),
    hour: String(date.getHours()),
    minute: String(date.getMinutes()),
  };
}

const { year, month, day, hour, minute } = getDateString();

Page({
  data: {
    value1: [year, month, day, hour, minute],
    value2: [year, month, day],
    value3: [year, month],
    value4: [year],
    value5: [hour, minute],
    value6: [year, month, day, hour, minute, '1'],
    value7: [hour, minute, '1'],
    lang: 'zh_CN',
  },
  onChange(e) {
    console.log(e);
    const { key, values } = e.detail;
    const lang = values[key];

    this.setData({
      lang,
    });
  },
  setValue(values: DatePickerViewGetValue, key: number) {
    this.setData({
      [`value${key}`]: values.value,
      [`displayValue${key}`]: values.displayValue.join(' '),
    });
  },
  onValueChange(e) {
    const { index } = e.currentTarget.dataset;
    this.setValue(e.detail, index);
    console.log(`onValueChange${index as number}`, e.detail);
  },
});
```

## API

### DatePickerView props

| 参数                 | 类型            | 描述                                                                                                 | 默认值                |
| -------------------- | --------------- | ---------------------------------------------------------------------------------------------------- | --------------------- |
| multiPickerPrefixCls | `string`        | multPicker 自定义类名前缀                                                                            | wux-picker            |
| pickerPrefixCls      | `string`        | picker 自定义类名前缀                                                                                | wux-picker-col        |
| value                | `any`           | 当前选中时间，例如字符串 `2000-02-01 00:00:00` 或时间戳 `949334400000` 或者数组 `[2000, 1, 1, 0, 0]` | -                     |
| itemHeight           | `number`        | 每列子元素的高度                                                                                     | 34                    |
| itemStyle            | `string,object` | 每列子元素的样式                                                                                     | -                     |
| indicatorStyle       | `string,object` | 设置选择器中间选中框的样式                                                                           | -                     |
| indicatorClass       | `string`        | 设置选择器中间选中框的类名                                                                           | -                     |
| maskStyle            | `string,object` | 设置蒙层的样式                                                                                       | -                     |
| maskClass            | `string`        | 设置蒙层的类名                                                                                       | -                     |
| labelAlign           | `string`        | 设置文本对齐方式，可选值为 right、center、left                                                       | center                |
| mode                 | `string`        | 日期选择的类型，可选值为 datetime、date、year、month、time                                           | datetime              |
| minuteStep           | `number`        | 分钟数递增步长                                                                                       | 1                     |
| use12Hours           | `boolean`       | 是否显示 12 小时制                                                                                   | false                 |
| minDate              | `any`           | 最小可选日期                                                                                         | `2000-02-01 00:00:00` |
| maxDate              | `any`           | 最大可选日期                                                                                         | `2030-02-01 23:59:59` |
| minHour              | `number`        | 最小可选小时                                                                                         | 0                     |
| maxHour              | `number`        | 最大可选小时                                                                                         | 23                    |
| minMinute            | `number`        | 最小可选分钟                                                                                         | 0                     |
| maxMinute            | `number`        | 最大可选分钟                                                                                         | 59                    |
| lang                 | `string`        | 返回文本的语言，可选值为 en、zh_CN、zh_TW                                                            | zh_CN                 |
| bind:valueChange     | `function`      | 每列数据选择变化后的回调函数                                                                         | -                     |

---
_Source: https://npm.io/package/@wines/date-picker-view · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
