সূচক
তারিখ সময়
নাগরিক সময় (বা মাঝে মাঝে শারীরিক সময়) প্রতিনিধিত্ব করে।
এই প্রকারটি কয়েকটি সম্ভাব্য উপায়ের একটিতে একটি নাগরিক সময়কে উপস্থাপন করতে পারে:
- যখন utc_offset সেট করা হয় এবং time_zone সেট করা না থাকে: UTC থেকে একটি নির্দিষ্ট অফসেট সহ একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
- যখন time_zone সেট করা হয় এবং utc_offset আনসেট করা হয়: একটি নির্দিষ্ট সময় অঞ্চলে একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
- যখন টাইম_জোন বা utc_offset সেট করা হয় না: স্থানীয় সময় একটি ক্যালেন্ডার দিনে একটি নাগরিক সময়।
তারিখটি প্রোলেপটিক গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত।
যদি বছর, মাস বা দিন 0 হয়, তবে তারিখ সময়কে যথাক্রমে একটি নির্দিষ্ট বছর, মাস বা দিন নেই বলে মনে করা হয়।
যদি সমস্ত তারিখ এবং সময় ক্ষেত্র সেট করা থাকে এবং time_offset এর যেকোন একটি সেট করা থাকলে এই প্রকারটি একটি ভৌত সময়ের প্রতিনিধিত্ব করতেও ব্যবহার করা যেতে পারে। পরিবর্তে শারীরিক সময়ের জন্য Timestamp বার্তা ব্যবহার করার কথা বিবেচনা করুন। যদি আপনার ব্যবহারের ক্ষেত্রেও ব্যবহারকারীর টাইমজোন সংরক্ষণ করতে চান, তবে এটি অন্য ক্ষেত্রে করা যেতে পারে।
এই ধরনের কিছু অ্যাপ্লিকেশন চাইতে পারে তুলনায় আরো নমনীয়. আপনার আবেদনের সীমাবদ্ধতাগুলি নথিভুক্ত এবং যাচাই করা নিশ্চিত করুন৷
| ক্ষেত্র | |
|---|---|
year | ঐচ্ছিক। তারিখের বছর। 1 থেকে 9999 পর্যন্ত হতে হবে, অথবা 0 হতে হবে যদি একটি বছর ছাড়া একটি তারিখ সময় উল্লেখ করা হয়। |
month | ঐচ্ছিক। বছরের মাস। 1 থেকে 12, অথবা 0 হতে হবে যদি একটি মাস ছাড়া তারিখের সময় উল্লেখ করা হয়। |
day | ঐচ্ছিক। মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 দিন ছাড়া তারিখের সময় উল্লেখ করলে। |
hours | ঐচ্ছিক। 24 ঘন্টা বিন্যাসে দিনের ঘন্টা. 0 থেকে 23 পর্যন্ত হওয়া উচিত, ডিফল্ট 0 থেকে (মধ্যরাত)। একটি API ব্যবসা বন্ধ হওয়ার সময় মত পরিস্থিতির জন্য "24:00:00" মানকে অনুমতি দিতে বেছে নিতে পারে। |
minutes | ঐচ্ছিক। দিনের ঘন্টার মিনিট। 0 থেকে 59 হতে হবে, ডিফল্ট 0 থেকে। |
seconds | ঐচ্ছিক। সময়ের মিনিটের সেকেন্ড। সাধারণত 0 থেকে 59 হতে হবে, ডিফল্ট 0 হতে হবে। একটি API 60 মানকে অনুমতি দিতে পারে যদি এটি লিপ-সেকেন্ডের অনুমতি দেয়। |
nanos | ঐচ্ছিক। ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। 0 থেকে 999,999,999 হতে হবে, ডিফল্ট 0 থেকে। |
ইউনিয়ন ফিল্ড time_offset । ঐচ্ছিক। হয় UTC অফসেট বা তারিখের সময় অঞ্চল নির্দিষ্ট করে৷ তাদের মধ্যে সাবধানে বেছে নিন, ভবিষ্যতে সময় অঞ্চলের ডেটা পরিবর্তিত হতে পারে তা বিবেচনা করে (উদাহরণস্বরূপ, একটি দেশ তাদের DST শুরু/শেষ তারিখগুলি পরিবর্তন করে এবং প্রভাবিত পরিসরে ভবিষ্যতের তারিখের সময়গুলি ইতিমধ্যেই সংরক্ষণ করা হয়েছে)। যদি বাদ দেওয়া হয়, তারিখ সময় স্থানীয় সময় হিসাবে বিবেচিত হয়। time_offset নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
utc_offset | UTC অফসেট। সম্পূর্ণ সেকেন্ড হতে হবে, -18 ঘন্টা এবং +18 ঘন্টার মধ্যে৷ উদাহরণস্বরূপ, -4:00-এর একটি UTC অফসেটকে { সেকেন্ড: -14400 } হিসাবে উপস্থাপন করা হবে৷ |
time_zone | সময় অঞ্চল. |
দিনের সময়
দিনের একটি সময় প্রতিনিধিত্ব করে। তারিখ এবং সময় অঞ্চল হয় উল্লেখযোগ্য নয় বা অন্য কোথাও নির্দিষ্ট করা হয়েছে৷ একটি API লিপ সেকেন্ডের অনুমতি দিতে বেছে নিতে পারে। সম্পর্কিত প্রকারগুলি হল google.type.Date এবং google.protobuf.Timestamp ।
| ক্ষেত্র | |
|---|---|
hours | 24 ঘন্টা বিন্যাসে দিনের ঘন্টা. 0 থেকে 23 পর্যন্ত হওয়া উচিত। ব্যবসা বন্ধ হওয়ার সময় মত পরিস্থিতির জন্য একটি API "24:00:00" মানকে অনুমতি দিতে পারে। |
minutes | দিনের ঘন্টার মিনিট। 0 থেকে 59 এর মধ্যে হতে হবে। |
seconds | সময়ের মিনিটের সেকেন্ড। সাধারণত 0 থেকে 59 এর মধ্যে হতে হবে। একটি API 60 মান অনুমোদন করতে পারে যদি এটি লিপ-সেকেন্ডের অনুমতি দেয়। |
nanos | ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। 0 থেকে 999,999,999 পর্যন্ত হতে হবে। |
সময় অঞ্চল
IANA টাইম জোন ডেটাবেস থেকে একটি সময় অঞ্চল প্রতিনিধিত্ব করে৷
| ক্ষেত্র | |
|---|---|
id | IANA টাইম জোন ডাটাবেস টাইম জোন, যেমন "America/New_York"। |
version | ঐচ্ছিক। IANA টাইম জোন ডেটাবেস সংস্করণ নম্বর, যেমন "2019a"। |