TimePicker 时间选择框

输入或选择时间的控件。

何时使用

当用户需要输入一个时间，可以点击标准输入框，弹出时间面板进行选择。

代码演示

12 小时制

12 小时制的时间选择器，默认的 format 为 h:mm:ss a。

<template>
  <div>
    <a-time-picker use12-hours @change="onChange" />
    <a-time-picker use12-hours format="h:mm:ss A" @change="onChange" />
    <a-time-picker use12-hours format="h:mm a" @change="onChange" />
  </div>
</template>
<script>
export default {
  methods: {
    onChange(time, timeString) {
      console.log(time, timeString);
    },
  },
};
</script>

基本

点击 TimePicker，然后可以在浮层中选择或者输入某一时间。

<template>
  <a-time-picker :default-open-value="moment('00:00:00', 'HH:mm:ss')" @change="onChange" />
</template>
<script>
import moment from 'moment';
export default {
  methods: {
    moment,
    onChange(time, timeString) {
      console.log(time, timeString);
    },
  },
};
</script>

**

选择时分

TimePicker 浮层中的列会随着 format 变化，当略去 format 中的某部分时，浮层中对应的列也会消失。

<template>
  <a-time-picker :default-value="moment('12:08', 'HH:mm')" format="HH:mm" />
</template>
<script>
import moment from 'moment';
export default {
  methods: {
    moment,
  },
};
</script>

三种大小

三种大小的输入框，大的用在表单中，中的为默认。

<template>
  <div>
    <a-time-picker :default-value="moment('12:08:23', 'HH:mm:ss')" size="large" />
    <a-time-picker :default-value="moment('12:08:23', 'HH:mm:ss')" />
    <a-time-picker :default-value="moment('12:08:23', 'HH:mm:ss')" size="small" />
  </div>
</template>
<script>
import moment from 'moment';
export default {
  methods: {
    moment,
  },
};
</script>

后缀图标

点击 TimePicker，然后可以在浮层中选择或者输入某一时间。

<template>
  <a-time-picker :default-open-value="moment('00:00:00', 'HH:mm:ss')" @change="onChange">
    <a-icon slot="suffixIcon" type="smile" />
  </a-time-picker>
</template>
<script>
import moment from 'moment';
export default {
  methods: {
    moment,
    onChange(time, timeString) {
      console.log(time, timeString);
    },
  },
};
</script>

附加内容

在 TimePicker 选择框底部显示自定义的内容。

<template>
  <div>
    <a-time-picker :open="open" @openChange="handleOpenChange">
      <a-button slot="addon" slot-scope="panel" size="small" type="primary" @click="handleClose">
        Ok {{ panel.prefixCls }}
      </a-button>
    </a-time-picker>
    <a-time-picker :open.sync="open2">
      <a-button slot="addon" size="small" type="primary" @click="handleClose">
        Ok
      </a-button>
    </a-time-picker>
  </div>
</template>
<script>
import moment from 'moment';
export default {
  data() {
    return {
      open: false,
      open2: false,
    };
  },
  methods: {
    handleOpenChange(open) {
      console.log('open', open);
      this.open = open;
    },
    handleClose() {
      this.open = false;
      this.open2 = false;
    },
  },
};
</script>

禁用

禁用时间选择。

<template>
  <a-time-picker :default-value="moment('12:08:23', 'HH:mm:ss')" disabled />
</template>
<script>
import moment from 'moment';
export default {
  methods: {
    moment,
  },
};
</script>

步长选项

可以使用 hourStep minuteStep secondStep 按步长展示可选的时分秒。

<template>
  <a-time-picker :minute-step="15" :second-step="10" />
</template>

受控组件

value 和 onChange 需要配合使用。也可以直接使用v-model。

<template>
  <div>
    <p>use value and @change</p>
    <a-time-picker :value="value" @change="onChange" />
    <br />
    <br />
    <p>v-model</p>
    <a-time-picker v-model="value" />
    <br />
    <br />
    <p>Do not change</p>
    <a-time-picker :value="value2" />
  </div>
</template>
<script>
import moment from 'moment';
export default {
  data() {
    return {
      value: null,
      value2: moment(),
    };
  },
  methods: {
    onChange(time) {
      console.log(time);
      this.value = time;
    },
  },
};
</script>

API

事件

方法