---
title: مدت زمان
id: duration
full_link:
short_description: >
  یک مقدار رشته‌ای که نشان‌دهنده‌ی مدت زمان است.
tags:
- fundamental
---
یک مقدار رشته‌ای که نشان‌دهنده‌ی مدت زمان است.

<!--more-->

قالب مدت زمان (کوبرنتیز) بر اساس نوع ‎[`time.Duration`](https://pkg.go.dev/time#Duration)‎ از زبان برنامه‌نویسی Go است.

در APIهای کوبرنتیز که از مدت زمان استفاده می‌کنند، مقدار به صورت مجموعه‌ای از اعداد صحیح غیر منفی همراه با پسوند واحد زمان بیان می‌شود. می‌توانید بیش از یک مقدار زمانی داشته باشید و مدت زمان، مجموع آن مقادیر زمانی است.
واحدهای زمانی معتبر عبارتند از "ns"، "µs" (یا "us")، "ms"، "s"، "m" و "h".

به عنوان مثال: `5s` نشان دهنده مدت زمان پنج ثانیه و `1m30s` نشان دهنده مدت زمان است.
یک دقیقه و سی ثانیه است.