Relative Date Field

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

RelativeDateField el componente se usa solo para introducir fechas relativas. No se puede usar como «normal» DateField.

Entrada relativa

El componente obtiene los valores en un formato relativo especial. Establece valores como fórmulas que le ayudarán a calcular la fecha exacta. Podemos llamarlo grafana-like format porque es muy similar al formato de los campos de tiempo relativo de Grafana. Para obtener más información sobre los valores de tiempo relativo en Grafana, lea los documentos.

Con este modo, puede entregar los datos del origen al destino y calcular el valor exacto directamente en el punto final necesario sin imprecisiones.

Reglas de entrada válidas

  • un valor debe partir de una palabra clave now
  • la expresión de fecha relativa en común se ve así: now${operand}${count}${unit}
  • valores disponibles para operand:
    • -- resta
    • +- adición
    • /- llevando al inicio de la unit
  • valores válidos de count - cualquier número natural
  • valores válidos de unit:
    • d- día
    • w- semana
    • M- mes
    • Q- cuarto
    • y- año
    • h- hora
    • m- minuto

Ejemplos de uso

now-1d

now/w

now+10d-5d/M

Propiedades

NombreDescripciónTipoPredeterminado
aria, descrita porEl aria-describedby atributo del controlstring
detalles de ariaEl aria-details atributo del controlstring
etiqueta ariaEl aria-label atributo del controlstring
aria - etiquetada porEl aria-labelledby atributo del controlstring
autoFocusEl autofocus atributo del controlboolean
classNameEl nombre de la clase contenedora del controlstring
defaultValueEstablece el valor inicial del componente no controlado.string
inhabilitadoIndica que el usuario no puede interactuar con el controlbooleanfalse
errorMessageTexto de errorReactNode
hasClearMuestra el icono para borrar el valor del controlbooleanfalse
hasTimeMostrar campo de tiempo en popupvaluebooleanfalse
identificaciónEl id atributo del controlstring
etiquetaTexto de ayuda representado a la izquierda del nodo de entradastring
leftContentEl nodo del usuario`renderizado antes de la etiqueta y la entradaReact.ReactNode
onBlurSe dispara cuando el control pierde el foco. Proporciona un evento de enfoque como argumento de devolución de llamada(e: focusEvent<Element, Element> () => vacío)
onFocusSe dispara cuando el control se enfoca. Proporciona un evento de enfoque como argumento de devolución de llamada(e: focusEvent<Element, Element> () => vacío)
onKeyDownSe dispara cuando se pulsa una tecla. Proporciona un evento de teclado como argumento de devolución de llamada(e: KeyboardEvent<Element>) = nulo)>
onKeyUpSe dispara cuando se suelta una tecla. Proporciona un evento de teclado como argumento de devolución de llamada(e: KeyboardEvent<Element>) = nulo)>
onUpdateSe activa cuando el usuario cambia el valor. Proporciona un nuevo valor como argumento de devolución de llamada(valor: cadena| nulo) => nulo
alfilerRedondeo de esquinasstring'round-round'
marcador de posiciónTexto que aparece en el control cuando no tiene ningún valor establecidostring
readOnlySi el valor del componente es inmutable.booleanfalse
rightContentEl nodo del usuario`se representa después del nodo de entrada y el botón de borrarReact.ReactNode
tamañoEl tamaño del control"s" "xl""m"
estiloEstablece el estilo en línea del elemento.CSSProperties
timeZoneEstablece la zona horaria. Más información sobre las zonas horariasstring
validationStateEstado de validación"invalid"
valorEl valor del controlstring null
vistaLa vista del control"normal" "clear""normal"