TIMEW-IMPORT(1)                  User Manuals                  TIMEW-IMPORT(1)

نام (NAME)
       timew-import - وارد کردن داده‌های ردیابی زمان از فایل‌ها

خلاصه دستور (SYNOPSIS)
       timew import [<file>...]

توضیحات (DESCRIPTION)
       وارد کردن زمان‌های ردیابی‌شده از file.  اگر فایلی مشخص نشود، دستور از
       ورودی استاندارد خواهد خواند.

       داده‌های واردشونده باید در قالب JSON باشند، همان‌طور که توسط
       timew-export(1) صادر می‌شوند؛ یعنی یک آرایهٔ تکی حاوی شیءهای بازه زمانی
       (interval objects).

       هنگام واردسازی، بازه‌ها از نظر هم‌پوشانی با بازه‌های موجود بررسی می‌شوند.
       اگر هم‌پوشانی یافت شود، فرایند واردسازی در اولین تداخل متوقف شده و هیچ
       بازهٔ دیگری وارد نخواهد شد، مگر اینکه هینت :adjust مشخص شده باشد.

       به‌طور کلی، توصیه می‌شود پیش از واردسازی، از داده‌های خود یک نسخهٔ پشتیبان
       تهیه کنید.

نکات (HINTS)
       :adjust
           در صورت مشخص شدن، بازهٔ واردشده روی هر بازهٔ موجودی که با آن تداخل و
           هم‌پوشانی داشته باشد بازنویسی خواهد شد.

مثال‌ها (EXAMPLES)
       وارد کردن بازه‌ها از یک فایل

           وارد کردن بازه‌ها از یک فایل منفرد:

               timew import intervals.json

           هر مسیر فایلی که با / آغاز نشود، به‌صورت نسبی نسبت به دایرکتوری کاری
           فعلی تفسیر می‌شود.

       وارد کردن بازه‌ها از چندین فایل

           همچنین می‌توان از نویسه‌های عمومی شل (wildcards) و مسیرهای مطلق
           استفاده کرد:

               timew import /path/to/intervals/*.json

       وارد کردن بازه‌ها از ورودی استاندارد

           وارد کردن بازه‌ها از stdin:

               timew export | ssh <server> 'timew import'

           این روش به‌ویژه برای همگام‌سازی بازه‌ها بین ماشین‌های مختلف مفید است.

timew 1.9.1                       2025-08-16                   TIMEW-IMPORT(1)