Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
"use client";
import {
formatDate,
formatDateTime,
formatDateTimeInZone,
formatPreciseDuration,
formatRelativeCalendarDays,
formatRelativeTime,
getTimeZoneOffsetLabel
} from "@carbon/utils";
import { getLocalTimeZone, parseDate, today } from "@internationalized/date";
import { Trans } from "@lingui/react/macro";
import { useLocale } from "@react-aria/i18n";
import type { ReactNode } from "react";
import { useState } from "react";
import {
Tooltip,
TooltipArrow,
TooltipContent,
TooltipTrigger
} from "./Tooltip";
import { cn } from "./utils/cn";
export type DateTimeProps = {
/** ISO timestamp (a UTC instant, e.g. `createdAt`) or a `YYYY-MM-DD` date */
value: string | null | undefined;
/**
* Inline text style:
* - `relative` — "3 hours ago"
* - `absolute` — short date + short time
* - `time` — time of day only
* - `date` — date only (no time-of-day)
*/
variant?: "relative" | "absolute" | "time" | "date";
/** The company's IANA timezone (ledger calendar) — the Company row. */
companyTimeZone?: string;
/** The relevant location's IANA timezone (operational) — the Location row. */
locationTimeZone?: string;
/** Custom trigger element (e.g. an info icon) instead of the formatted text. */
children?: ReactNode;
/**
* Intl options for the inline text of `variant="date"`, so each call site
* keeps the exact format it rendered before (defaults to `formatDate`'s
* medium style). Ignored by the other variants.
*/
dateOptions?: Intl.DateTimeFormatOptions;
fallback?: ReactNode;
className?: string;
side?: "top" | "bottom" | "left" | "right";
};
/** One popover row, as grid cells so chips / labels / dates / times align in
* shared columns across all rows. */
function TooltipRow({
label,
labelTitle,
suffix,
value,
timeZone,
locale
}: {
label: string;
labelTitle?: string;
suffix: ReactNode;
value: string;
timeZone: string;
locale: string;
}) {
return (
<>
<span
title={labelTitle}
className="inline-flex w-fit items-center rounded bg-muted px-1.5 py-px font-mono text-[0.6875rem] text-foreground/80"
>
{label}
</span>
<span className="text-[10px] font-medium uppercase tracking-wide text-muted-foreground">
{suffix}
</span>
<span className="justify-self-end text-xs font-medium tabular-nums">
{formatDateTimeInZone(value, timeZone, locale, {
dateStyle: undefined,
timeStyle: undefined,
month: "short",
day: "numeric",
year: "numeric"
})}
</span>
<span className="justify-self-end pl-6 font-mono text-xs tabular-nums text-muted-foreground">
{formatDateTimeInZone(value, timeZone, locale, {
dateStyle: undefined,
timeStyle: undefined,
hour: "2-digit",
minute: "2-digit",
hour12: true
})}
</span>
</>
);
}
const DateTime = ({
value,
variant = "absolute",
companyTimeZone,
locationTimeZone,
children,
dateOptions,
fallback = null,
className,
side = "top"
}: DateTimeProps) => {
const { locale } = useLocale();
const [open, setOpen] = useState(false);
if (!value) return <>{fallback}</>;
const viewerTimeZone = getLocalTimeZone();
const isDate = variant === "date";
// A bare `YYYY-MM-DD` is a business date — its day starts at midnight on the
// operational calendar: the location's when known, else the company's.
// `toDate` resolves DST-skipped midnights to the day's true first instant.
const anchorTimeZone = locationTimeZone ?? companyTimeZone ?? "UTC";
const hasTime = value.includes("T");
let instant = value;
if (!hasTime) {
try {
instant = parseDate(value).toDate(anchorTimeZone).toISOString();
} catch {
instant = `${value}T00:00:00Z`;
}
}
const inline =
variant === "relative"
? formatRelativeTime(value, locale)
: variant === "time"
? formatDateTimeInZone(value, viewerTimeZone, locale, {
dateStyle: undefined,
timeStyle: "short"
})
: isDate
? formatDate(value, dateOptions, locale)
: formatDateTime(value, locale);
// Rows in fixed order: Company, Location, Local — dedupe identical zones so
// a single-site viewer in the company zone sees one meaningful row.
const showLocationRow =
!!locationTimeZone && locationTimeZone !== companyTimeZone;
const showLocalRow =
viewerTimeZone !== companyTimeZone && viewerTimeZone !== locationTimeZone;
// Computed once when the popover opens (the render `open` triggers) — no
// ticking interval; the diff is a snapshot of the moment you opened it.
// Bare dates get the coarse day-level distance instead of a fake
// to-the-second one.
let precise: { text: string; direction: "past" | "future" } | null = null;
if (open && hasTime) {
precise = formatPreciseDuration(value, locale);
}
// Only resolve offset labels while the tooltip is open — a table can mount
// hundreds of these and the parse/format is not free.
const companyOffsetLabel =
open && companyTimeZone
? getTimeZoneOffsetLabel(instant, companyTimeZone)
: "";
const locationOffsetLabel =
open && locationTimeZone
? getTimeZoneOffsetLabel(instant, locationTimeZone)
: "";
const viewerOffsetLabel = open
? getTimeZoneOffsetLabel(instant, viewerTimeZone)
: "";
return (
<Tooltip open={open} onOpenChange={setOpen} delayDuration={200}>
<TooltipTrigger asChild>
{children ? (
<span className={cn("inline-flex items-center", className)}>
{children}
</span>
) : (
<time
dateTime={value}
suppressHydrationWarning
className={cn(
"cursor-pointer whitespace-nowrap underline decoration-muted-foreground/50 decoration-dotted underline-offset-[3px] transition-colors hover:decoration-foreground/70",
// Phones: the hover tooltip is off, so nothing hints it is interactive.
"max-md:no-underline max-md:cursor-auto",
className
)}
>
{inline}
</time>
)}
</TooltipTrigger>
{open && (
<TooltipContent side={side} className="max-w-none p-0">
<TooltipArrow />
<div className="flex items-center justify-between gap-8 border-b border-border px-3 py-2 text-xs tabular-nums">
<span className="text-muted-foreground">
{precise?.direction === "future" ? (
<Trans>in {precise?.text}</Trans>
) : precise ? (
<Trans>{precise?.text} ago</Trans>
) : (
// Bare date: exact day distance on the operational calendar —
// "in 8 days", not a vague "next week".
formatRelativeCalendarDays(
value,
today(anchorTimeZone).toString(),
locale
)
)}
</span>
<span className="font-mono text-muted-foreground">
{formatDateTimeInZone(instant, "UTC", locale, {
dateStyle: undefined,
timeStyle: undefined,
month: "short",
day: "numeric",
year: "numeric"
})}
{" – "}
{formatDateTimeInZone(instant, "UTC", locale, {
dateStyle: undefined,
timeStyle: undefined,
hour: "2-digit",
minute: "2-digit",
hour12: true
})}{" "}
UTC
</span>
</div>
<div className="grid grid-cols-[auto_auto_1fr_auto] items-center gap-x-2.5 gap-y-1.5 px-3 py-2.5 text-[0.8125rem]">
{companyTimeZone && (
<TooltipRow
label={companyOffsetLabel}
labelTitle={companyTimeZone}
suffix={<Trans>Company</Trans>}
value={instant}
timeZone={companyTimeZone}
locale={locale}
/>
)}
{showLocationRow && (
<TooltipRow
label={locationOffsetLabel}
labelTitle={locationTimeZone}
suffix={<Trans>Location</Trans>}
value={instant}
timeZone={locationTimeZone}
locale={locale}
/>
)}
{showLocalRow && (
<TooltipRow
label={viewerOffsetLabel}
labelTitle={viewerTimeZone}
suffix={<Trans>Local</Trans>}
value={instant}
timeZone={viewerTimeZone}
locale={locale}
/>
)}
</div>
</TooltipContent>
)}
</Tooltip>
);
};
DateTime.displayName = "DateTime";
export { DateTime };