نام (NAME)

timew-get - نمایش مقادیر DOM

خلاصه دستور (SYNOPSIS)

timew get <DOM>...

مرجع DOM را اعتبارسنجی می‌کند، سپس مقدار آن را به‌دست آورده و نمایش می‌دهد.

در صورت نامعتبر بودن مرجع، یک پیام خطا در stderr نمایش داده می‌شود و وضعیت خروج ۱ خواهد بود.

تمام مراجع DOM با dom آغاز می‌شوند؛ ۴ زیرمرجع وجود دارد که می‌توان به آن‌ها دسترسی داشت:

•dom.tracked، تمام بازه‌ها

•dom.active، ردیابی زمان فعال

•dom.tags، تمام برچسب‌ها

•dom.rc، تنظیمات پیکربندی

برای جزئیات بیشتر درباره این موارد، timew-config(7) را ببینید. ارجاع به بازه یا برچسبی که وجود ندارد، یک خطا محسوب می‌شود.

اگر بیش از یک مرجع معتبر DOM داده شود، نتایج با یک فاصله به یکدیگر متصل می‌شوند.

پرس‌وجوی وضعیت ردیابی زمان جاری

$ timew get dom.active 1

این پرس‌وجو در صورتی که ردیابی زمان فعال باشد 1، و در غیر این صورت 0 را برمی‌گرداند.

نمایش سومین بازه از یک پرس‌وجو به صورت JSON

برای مرجع dom.tracked می‌توان فیلترسازی بر اساس محدوده و برچسب‌ها را اعمال کرد:

$ timew get dom.tracked.3.json :month FOO
{"id":42,"start":"20250802T101224Z","end":"20250802T101224Z","tags":["FOO","BAR"]}

توجه داشته باشید که عدد 3 در مرجع به سومین بازه در نتیجه پرس‌وجو اشاره دارد، نه بازه‌ای با شناسه 3!