Series: React Hook Form Lesson 68

Date Picker Integration — Sana tanlovchi komponentlarni ulash

Date | null va string qiymatlar, useController orqali DatePicker vidjetlarini ulash, cross-field sana validatsiyasi va API formatiga o'tkazish.

68-dars

Date Picker Integration

Date Picker Integration — bu oddiy <input type="date"> o'rniga maxsus (custom) yoki tashqi kutubxonalarning DatePicker komponentlarini (kalendar popup, sana oralig'i / date range, vaqt bilan birga / datetime yoki Date / ISO string / Dayjs / Luxon qiymat qaytaruvchi vidjetlar) React Hook Form bilan bog'lash jarayonidir.

Standart HTML <input type="date"> brauzerga bog'liq ko'rinishga ega va faqat "YYYY-MM-DD" ko'rinishidagi matn qaytaradi. Zamonaviy UI kutubxonalari (shadcn/ui, MUI X Date Pickers, Mantine, Ant Design, React Datepicker) esa o'zining popover kalendariga ega bo'lib, o'zgarish hodisasida to'g'ridan-to'g'ri Date | null yoki kutubxona obyektini qaytaradi. Shuning uchun ularni <Controller> yoki useController() orqali field.value, field.onChange, field.onBlur va field.ref bilan ulash eng toza va xavfsiz usul hisoblanadi.


1. Date Picker ulashda asosiy nuqtalar

Jihat Nimaga e'tibor berish kerak? Tavsiya etiladigan yondashuv
Qiymat tipi (Date | null vs string) UI komponent Date obyekti qaytarishi mumkin, lekin backend API ko'pincha ISO 8601 ("2026-11-20T00:00:00.000Z") yoki "YYYY-MM-DD" kutadi. FormValues ichida komponentga qulay bo'lgan Date | null tipini saqlang va onSubmit ichida backend kutgan formatga o'giring.
defaultValues boshlang'ich qiymati Boshlang'ich qiymat berilmasa, React Hook Form uni undefined deb oladi va controlled komponent ogohlantirish (uncontrolled to controlled) berishi mumkin. Bo'sh holat uchun undefined emas, aniq null (yoki bo'sh matn "") bering.
Sana validatsiyasi (cross-field) Masalan, tugash sanasi (endDate) boshlanish sanasidan (startDate) oldin bo'lmasligi yoki ma'lum yosh/chegaradan kichik bo'lmasligi kerak. rules={{ validate: (val, formValues) => ... }} orqali sanalarning getTime() qiymatini taqqoslang va trigger() bilan o'zaro bog'lang.
Serverga yuborish va Timezone new Date().toISOString() yoki JSON.stringify() chaqirilganda foydalanuvchining mahalliy vaqti UTC ga o'tishi natijasida sana 1 kunga surilib qolishi mumkin. Faqat sana (kun/oy/yil) kerak bo'lsa, mahalliy yildan, oydan va kundan iborat "YYYY-MM-DD" formatini hosil qiling.
Fokus va Accessibility (a11y) Kalendar popup ochilganda klaviatura orqali boshqarish va xato paytida fokuslanish qiyinlashishi mumkin. field.ref ni trigger tugmaga yoki asosiy inputga bog'lang hamda aria-invalid atributini qo'shing.

2. Yordamchi sana funksiyalari (Timezone-safe)

Sanalarni "YYYY-MM-DD" ko'rinishida formatlash va parslashda mahalliy vaqtni (local timezone) saqlab qoluvchi yordamchi funksiyalar:

// Date obyektini mahalliy "YYYY-MM-DD" satriga o'tkazadi
export function formatInputDate(date: Date | null): string {
  if (!date || Number.isNaN(date.getTime())) return "";
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, "0");
  const day = String(date.getDate()).padStart(2, "0");
  return `${year}-${month}-${day}`;
}

// "YYYY-MM-DD" satrini mahalliy Date obyektiga o'tkazadi
export function parseInputDate(raw: string): Date | null {
  if (!raw) return null;
  const parts = raw.split("-").map(Number);
  if (parts.length !== 3) return null;
  const [y, m, d] = parts;
  if (!y || !m || !d) return null;

  // Mahalliy vaqt bo'yicha 00:00:00 ga sozlaymiz
  const parsed = new Date(y, m - 1, d, 0, 0, 0, 0);
  return Number.isNaN(parsed.getTime()) ? null : parsed;
}

3. Reusable Custom DatePicker va useController() komponenti

Tashqi kalendar picker'lar yoki o'zingiz yasagan modal/popover vidjetlar uchun universal useController() o'rami:

import React from "react";
import {
  useController,
  type Control,
  type FieldValues,
  type Path,
  type RegisterOptions,
} from "react-hook-form";

// Custom UI DatePicker komponentining prop interfeysi
type CustomDatePickerProps = {
  id?: string;
  value: Date | null;
  onChange: (date: Date | null) => void;
  onBlur?: () => void;
  minDate?: Date;
  invalid?: boolean;
};

// Tashqi kutubxona yoki maxsus kalendar o'rnida ishlovchi misol komponent
export function CustomDatePicker({
  id,
  value,
  onChange,
  onBlur,
  minDate,
  invalid,
}: CustomDatePickerProps) {
  const minAttr = minDate ? formatInputDate(minDate) : undefined;

  return (
    <div className="date-picker-container" style={{ display: "inline-flex", gap: "8px", alignItems: "center" }}>
      <input
        id={id}
        type="date"
        min={minAttr}
        value={formatInputDate(value)}
        onChange={(e) => onChange(parseInputDate(e.target.value))}
        onBlur={onBlur}
        aria-invalid={invalid}
        className={invalid ? "input-error" : ""}
      />
      {value && (
        <button
          type="button"
          onClick={() => onChange(null)}
          title="Sanani tozalash"
          style={{ padding: "2px 8px", cursor: "pointer" }}
        >
          ✕
        </button>
      )}
    </div>
  );
}

// React Hook Form bilan integratsiya qiluvchi universal komponent
type FormDatePickerFieldProps<T extends FieldValues> = {
  name: Path<T>;
  control: Control<T>;
  label: string;
  minDate?: Date;
  rules?: RegisterOptions<T, Path<T>>;
};

export function FormDatePickerField<T extends FieldValues>({
  name,
  control,
  label,
  minDate,
  rules,
}: FormDatePickerFieldProps<T>) {
  const { field, fieldState } = useController({
    name,
    control,
    rules,
  });

  const dateId = `datepicker-${String(name)}`;

  return (
    <div className="form-field" style={{ marginBottom: "16px" }}>
      <label htmlFor={dateId} style={{ display: "block", marginBottom: "4px", fontWeight: 600 }}>
        {label}
      </label>

      <CustomDatePicker
        id={dateId}
        value={(field.value as Date | null) ?? null}
        onChange={field.onChange}
        onBlur={field.onBlur}
        minDate={minDate}
        invalid={fieldState.invalid}
      />

      {fieldState.error && (
        <p role="alert" style={{ color: "#e11d48", fontSize: "13px", marginTop: "4px" }}>
          {fieldState.error.message}
        </p>
      )}
    </div>
  );
}

4. To'liq forma misoli: Cross-field sana validatsiyasi

Quyidagi misolda loyiha bosqichlari uchun boshlanish sanasi (startDate) va yakuniy muddat (deadlineDate) tanlanadi. deadlineDate hech qachon startDate sanasidan oldin bo'lishi mumkin emas:

import React from "react";
import { useForm, type SubmitHandler } from "react-hook-form";
import {
  FormDatePickerField,
  formatInputDate,
} from "./FormDatePicker";

type MilestoneScheduleFormValues = {
  startDate: Date | null;
  deadlineDate: Date | null;
};

export function MilestoneScheduleForm() {
  const {
    control,
    trigger,
    handleSubmit,
    reset,
    formState: { isSubmitting },
  } = useForm<MilestoneScheduleFormValues>({
    mode: "onChange",
    defaultValues: {
      startDate: new Date(2026, 10, 20), // 2026-11-20 boshlang'ich qiymat
      deadlineDate: null,
    },
  });

  const onSubmit: SubmitHandler<MilestoneScheduleFormValues> = async (data) => {
    // API simulyatsiyasi
    await new Promise((resolve) => setTimeout(resolve, 400));

    // Backend kutgan YYYY-MM-DD formatiga aylantirib yuboramiz
    const payload = {
      startDate: formatInputDate(data.startDate),
      deadlineDate: formatInputDate(data.deadlineDate),
    };

    console.log("Serverga yuborilayotgan sana ma'lumotlari:", payload);
    reset({
      startDate: null,
      deadlineDate: null,
    });
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)} noValidate style={{ maxWidth: "420px" }}>
      {/* 1. Boshlanish sanasi */}
      <FormDatePickerField
        name="startDate"
        control={control}
        label="Boshlanish sanasi"
        rules={{
          required: "Boshlanish sanasini tanlash shart",
          onChange: () => {
            // startDate o'zgarganda deadlineDate validatsiyasini qayta tekshiramiz
            void trigger("deadlineDate");
          },
        }}
      />

      {/* 2. Tugash sanasi (Deadline) — Cross-field tekshiruv bilan */}
      <FormDatePickerField
        name="deadlineDate"
        control={control}
        label="Tugash sanasi (Deadline)"
        rules={{
          required: "Tugash muddatini tanlang",
          validate: (value, formValues) => {
            const deadline = value as Date | null;
            const start = formValues.startDate;

            if (!deadline || !start) return true;

            // Vaqt farqlarisiz faqat sanalarning o'zini solishtirish
            const startMidnight = new Date(start.getFullYear(), start.getMonth(), start.getDate()).getTime();
            const deadlineMidnight = new Date(deadline.getFullYear(), deadline.getMonth(), deadline.getDate()).getTime();

            return (
              deadlineMidnight >= startMidnight ||
              "Tugash sanasi boshlanish sanasidan oldin bo'lishi mumkin emas"
            );
          },
        }}
      />

      <button
        type="submit"
        disabled={isSubmitting}
        style={{
          padding: "8px 18px",
          background: "#2563eb",
          color: "#fff",
          border: "none",
          borderRadius: "6px",
          cursor: isSubmitting ? "not-allowed" : "pointer",
        }}
      >
        {isSubmitting ? "Saqlanmoqda..." : "Jadvalni saqlash"}
      </button>
    </form>
  );
}

5. Timezone muammosi va uning oldini olish

Ko'plab dasturchilar Date obyektini serverga yuborishda quyidagi xatoga yo'l qo'yadilar:

// Xato yondashuv:
const payload = {
  date: data.startDate?.toISOString(), // "2026-11-19T19:00:00.000Z" (O'zbekiston UTC+5 bo'lgani uchun kechagi kunga o'tib qoladi!)
};

Agar sizga faqat sana (kun, oy, yil) kerak bo'lsa (masalan, tug'ilgan kun, pasport berilgan sana, loyiha muddati), hech qachon universal UTC toISOString() dan to'g'ridan-to'g'ri foydalanmang.

To'g'ri strategiya:

  1. Faqat sana kerak bo'lsa: formatInputDate(date) orqali mahalliy yil, oy va kundan iborat "YYYY-MM-DD" satrini yuboring.
  2. Aniq vaqt kerak bo'lsa (datetime, bron qilish vaqti): Foydalanuvchining mahalliy timezone offset'i bilan birga ISO formatida yuboring yoki date.toISOString() yuborilayotganini backend jamoasi bilan aniqlashtirib oling.

6. Xulosa va tavsiyalar

  1. null boshlang'ich qiymat: Controlled DatePicker'larning bo'sh holati uchun defaultValues da undefined o'rniga null bering.
  2. useController ko'prigi: Custom kalendar, popover va tashqi UI kutubxonalar (val: Date | null) => void interfeysida ishlagani uchun field.onChange va field.value orqali toza ulanadi.
  3. trigger() bilan sinxronlash: Boshlanish sanasi o'zgarganda trigger("deadlineDate") ni chaqirish orqali ikkinchi maydondagi xatolikni bir zumda to'g'rilash yoki ogohlantirish mumkin.
  4. Kun boshi (00:00:00) bo'yicha taqqoslash: Sanalarni getTime() orqali taqqoslashda soat va daqiqalar farqi sababli bir xil kundagi sanalar noto'g'ri xato bermasligi uchun ularni 00:00:00 ga keltiring.