Relative Date Field

view
size
placeholder
label
validationState
errorMessage
disabled
hasClear
hasTime
readOnly
pin
startContent
endContent
import {RelativeDateField} from '@gravity-ui/date-components';

RelativeDateField 组件仅用于输入相对日期。它不能用作 “普通” DateField

相对输入

该组件以特殊的相对格式获取值。您可以将值设置为公式,这将有助于您计算确切的日期。我们可以称之为它, grafana-like format 因为它与 Grafana 相对时间字段的格式非常相似。要了解有关 Grafana 中的相对时间值的更多信息 ,请阅读文档

使用此模式,您可以将数据从源传输到目标,并直接在必要的端点上计算出确切的值,而不会出现不准确的情况。

有效的输入规则

  • 值应该从关键字开始 now
  • 常见的相对日期表达式如下所示: now${operand}${count}${unit}
  • 以下各项的可用值 operand
    • - -减法
    • + -加法
    • / -把它带到一开始 unit
  • 有效值 count -任意自然数
  • unit以下的有效值:
    • d -天
    • w -周
    • M -月
    • Q -四分之一
    • y -年
    • h -小时
    • m -分钟

用法示例

now-1d

now/w

now+10d-5d/M

属性

姓名描述类型默认
咏叹调描述者控件的 aria-describedby 属性string
aria-详细信息控件的 aria-details 属性string
aria-label控件的 aria-label 属性string
aria-labelledby控件的 aria-labelledby 属性string
autoFocus控件的 autofocus 属性boolean
className控件的包装器类名string
defaultValue设置非受控组件的初始值。string
残疾的表示用户无法与控件进行交互booleanfalse
errorMessage错误文本ReactNode
hasClear显示用于清除控件值的图标booleanfalse
hasTime在弹出值中显示时间字段booleanfalse
id控件的 id 属性string
标签在输入节点左侧呈现的帮助文本string
leftContent在标签和输入之前呈现的用户`节点React.ReactNode
onBlur当控件失去对焦时触发。提供焦点事件作为回调的参数(e:FocusEvent<Element, Element>) => 无效)
onFocus当控件获得焦点时触发。提供焦点事件作为回调的参数(e:FocusEvent<Element, Element>) => 无效)
onKeyDown按下按键时触发。提供键盘事件作为回调的参数(e:keyboardEvent<Element>) = void)>
onKeyUp释放密钥时触发。提供键盘事件作为回调的参数(e:keyboardEvent<Element>) = void)>
onUpdate当用户更改该值时触发。提供新值作为回调的参数(值:字符串| null) => 无效
大头针拐角处的圆角string'round-round'
占位符未设置值时在控件中显示的文本string
readOnly组件的值是否不可变。booleanfalse
rightContent在输入节点和清除按钮之后呈现的用户`节点React.ReactNode
尺寸控件的大小"s" "xl""m"
风格为元素设置行内样式。CSSProperties
timeZone设置时区。了解有关时区的更多信息string
validationState验证状态"invalid"
价值控件的价值string null
观点控件视图"normal" "clear""normal"