'\" t
.\"     Title: timew-import
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-16
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-IMPORT" "1" "2025-08-16" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
timew-import \- وارد کردن داده‌های ردیابی زمان از فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew import\fP [\fI<file>\fP\fB...\fP]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
وارد کردن زمان‌های ردیابی‌شده از \f(CRfile\fP.
اگر فایلی مشخص نشود، دستور از ورودی استاندارد خواهد خواند.
.sp
داده‌های واردشونده باید در قالب JSON باشند، همان‌طور که توسط \fBtimew\-export\fP(1) صادر می‌شوند؛ یعنی یک آرایهٔ تکی حاوی شیءهای بازه زمانی (interval objects).
.sp
هنگام واردسازی، بازه‌ها از نظر هم‌پوشانی با بازه‌های موجود بررسی می‌شوند.
اگر هم‌پوشانی یافت شود، فرایند واردسازی در اولین تداخل متوقف شده و هیچ بازهٔ دیگری وارد نخواهد شد، مگر اینکه هینت \f(CR:adjust\fP مشخص شده باشد.
.sp
به‌طور کلی، توصیه می‌شود پیش از واردسازی، از داده‌های خود یک نسخهٔ پشتیبان تهیه کنید.
.SH "نکات (HINTS)"
.sp
\fB:adjust\fP
.RS 4
در صورت مشخص شدن، بازهٔ واردشده روی هر بازهٔ موجودی که با آن تداخل و هم‌پوشانی داشته باشد بازنویسی خواهد شد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBوارد کردن بازه‌ها از یک فایل\fP
.RS 4
.sp
وارد کردن بازه‌ها از یک فایل منفرد:
.sp
.if n .RS 4
.nf
.fam C
timew import intervals.json
.fam
.fi
.if n .RE
.sp
هر مسیر فایلی که با \f(CR/\fP آغاز نشود، به‌صورت نسبی نسبت به دایرکتوری کاری فعلی تفسیر می‌شود.
.RE
.sp
\fBوارد کردن بازه‌ها از چندین فایل\fP
.RS 4
.sp
همچنین می‌توان از نویسه‌های عمومی شل (wildcards) و مسیرهای مطلق استفاده کرد:
.sp
.if n .RS 4
.nf
.fam C
timew import /path/to/intervals/*.json
.fam
.fi
.if n .RE
.RE
.sp
\fBوارد کردن بازه‌ها از ورودی استاندارد\fP
.RS 4
.sp
وارد کردن بازه‌ها از stdin:
.sp
.if n .RS 4
.nf
.fam C
timew export | ssh <server> \*(Aqtimew import\*(Aq
.fam
.fi
.if n .RE
.sp
این روش به‌ویژه برای همگام‌سازی بازه‌ها بین ماشین‌های مختلف مفید است.
.RE