Seletor de data e hora
Seletor de data & hora combinados.
Este componente combina os seletores de data & hora. Ele permite que o usuário selecione data e hora com o mesmo controle.
Note que este componente é cobinação dos componentes DatePicker eTimePicker, então qualquer uma das propriedades desses componentes pode ser passada para o DateTimePicker.
Requisitos
Este componente depende da biblioteca de gerenciamento de datas da sua escolha. Ele suporta date-fns, luxon, dayjs, moment e qualquer outra biblioteca através da interface publica dateAdapter
.
Por favor, instale qualquer uma destas bibliotecas e configure corretamente o mecanismo de data encapsulando na raiz dos componentes (ou o nível mais alto que você deseja que os seletores estejam disponíveis) com LocalizationProvider
:
// ou @material-ui/lab/Adapter{Dayjs,Luxon,Moment} ou qualquer adaptador válido de date-io
import AdapterDateFns from '@material-ui/lab/AdapterDateFns';
import LocalizationProvider from '@material-ui/lab/LocalizationProvider';
function App() {
return (
<LocalizationProvider dateAdapter={AdapterDateFns}>...</LocalizationProvider>
);
}
Utilização Básica
Permite escolher a data e hora. Existem 4 etapas disponíveis (ano, data, hora e minuto), então as abas são necessárias para distinguir visualmente os passos de data/hora.
<LocalizationProvider dateAdapter={AdapterDateFns}>
<DateTimePicker
renderInput={(props) => <TextField {...props} />}
label="DateTimePicker"
value={value}
onChange={(newValue) => {
setValue(newValue);
}}
/>
</LocalizationProvider>
Responsividade
O componente DateTimePicker
é projetado e otimizado para o dispositivo em que ele é executado.
- A versão "móvel" funciona melhor para dispositivos de toque e telas pequenas.
- A versão "desktop" funciona melhor para dispositivos com mouse e telas grandes.
Por padrão, o componente DateTimePicker
usa uma consulta de mídia @media (pointer: fine)
para determinar qual versão usar. Isto pode ser customizado com a propriedade desktopModeMediaQuery
.
mm/dd/yyyy hh:mm (a|p)m
Validação de data e hora
É possível restringir a seleção de data e hora de duas maneiras:
- por meio de
minDateTime
/maxDateTime
é possível restringir a seleção de tempo para antes ou após um determinado momento no tempo - usando
minTime
/maxTime
, você pode desabilitar selecionar horas antes ou depois de um certo tempo a cada dia, respectivamente
Hardcoded helper text
Clear Initial State