DateTime

নাগরিক সময় (বা মাঝে মাঝে শারীরিক সময়) প্রতিনিধিত্ব করে।

এই প্রকারটি কয়েকটি সম্ভাব্য উপায়ের একটিতে একটি নাগরিক সময়কে উপস্থাপন করতে পারে:

• যখন utcOffset সেট করা থাকে এবং টাইমজোন সেট না থাকে: UTC থেকে একটি নির্দিষ্ট অফসেট সহ একটি ক্যালেন্ডার দিনে একটি সিভিল সময়।
• যখন টাইমজোন সেট করা থাকে এবং utcOffset আনসেট থাকে: একটি নির্দিষ্ট সময় অঞ্চলে একটি ক্যালেন্ডারের দিনে একটি সিভিল সময়৷
• যখন টাইমজোন বা utcOffset সেট করা হয় না: স্থানীয় সময়ে একটি ক্যালেন্ডার দিনে একটি নাগরিক সময়৷

তারিখটি প্রোলেপটিক গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত।

যদি বছর, মাস বা দিন 0 হয়, তবে তারিখ সময়কে যথাক্রমে একটি নির্দিষ্ট বছর, মাস বা দিন নেই বলে মনে করা হয়।

যদি সমস্ত তারিখ এবং সময় ক্ষেত্র সেট করা থাকে এবং time_offset এর যেকোন একটি সেট করা থাকলে এই প্রকারটি একটি ভৌত ​​সময়ের প্রতিনিধিত্ব করতেও ব্যবহার করা যেতে পারে। পরিবর্তে শারীরিক সময়ের জন্য Timestamp বার্তা ব্যবহার করার কথা বিবেচনা করুন। যদি আপনার ব্যবহারের ক্ষেত্রেও ব্যবহারকারীর টাইমজোন সংরক্ষণ করতে চান, তবে এটি অন্য ক্ষেত্রে করা যেতে পারে।

এই ধরনের কিছু অ্যাপ্লিকেশন চাইতে পারে তুলনায় আরো নমনীয়. আপনার আবেদনের সীমাবদ্ধতাগুলি নথিভুক্ত এবং যাচাই করা নিশ্চিত করুন৷

JSON প্রতিনিধিত্ব
{ "year": integer, "month": integer, "day": integer, "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer, // Union field time_offset can be only one of the following: "utcOffset": string, "timeZone": { object (TimeZone) } // End of list of possible types for union field time_offset. }

ক্ষেত্র
year	integer ঐচ্ছিক। তারিখের বছর। 1 থেকে 9999 পর্যন্ত হতে হবে, অথবা 0 হতে হবে যদি একটি বছর ছাড়া একটি তারিখ সময় উল্লেখ করা হয়।
month	integer ঐচ্ছিক। বছরের মাস। 1 থেকে 12, অথবা 0 হতে হবে যদি একটি মাস ছাড়া তারিখের সময় উল্লেখ করা হয়।
day	integer ঐচ্ছিক। মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 দিন ছাড়া তারিখের সময় উল্লেখ করলে।
hours	integer ঐচ্ছিক। 24 ঘন্টা বিন্যাসে দিনের ঘন্টা. 0 থেকে 23 পর্যন্ত হওয়া উচিত, ডিফল্ট 0 থেকে (মধ্যরাত)। একটি API ব্যবসা বন্ধ হওয়ার সময় মত পরিস্থিতির জন্য "24:00:00" মানকে অনুমতি দিতে বেছে নিতে পারে।
minutes	integer ঐচ্ছিক। দিনের ঘন্টার মিনিট। 0 থেকে 59 হতে হবে, ডিফল্ট 0 থেকে।
seconds	integer ঐচ্ছিক। সময়ের মিনিটের সেকেন্ড। সাধারণত 0 থেকে 59 হতে হবে, ডিফল্ট 0 হতে হবে। একটি API 60 মানকে অনুমতি দিতে পারে যদি এটি লিপ-সেকেন্ডের অনুমতি দেয়।
nanos	integer ঐচ্ছিক। ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। 0 থেকে 999,999,999 হতে হবে, ডিফল্ট 0 থেকে।
ইউনিয়ন ফিল্ড time_offset । ঐচ্ছিক। হয় UTC অফসেট বা তারিখের সময় অঞ্চল নির্দিষ্ট করে৷ তাদের মধ্যে সাবধানে বেছে নিন, ভবিষ্যতে সময় অঞ্চলের ডেটা পরিবর্তিত হতে পারে তা বিবেচনা করে (উদাহরণস্বরূপ, একটি দেশ তাদের DST শুরু/শেষ তারিখগুলি পরিবর্তন করে এবং প্রভাবিত পরিসরে ভবিষ্যতের তারিখের সময়গুলি ইতিমধ্যেই সংরক্ষণ করা হয়েছে)। যদি বাদ দেওয়া হয়, তারিখ সময় স্থানীয় সময় হিসাবে বিবেচিত হয়। time_offset নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
utcOffset	string ( Duration format) UTC অফসেট। সম্পূর্ণ সেকেন্ড হতে হবে, -18 ঘন্টা এবং +18 ঘন্টার মধ্যে৷ উদাহরণস্বরূপ, -4:00-এর একটি UTC অফসেটকে { সেকেন্ড: -14400 } হিসাবে উপস্থাপন করা হবে৷ নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।
timeZone	object ( TimeZone ) সময় অঞ্চল।

টাইমজোন

IANA টাইম জোন ডেটাবেস থেকে একটি সময় অঞ্চল প্রতিনিধিত্ব করে৷

JSON প্রতিনিধিত্ব
{ "id": string, "version": string }

ক্ষেত্র
id	string IANA টাইম জোন ডাটাবেস টাইম জোন, যেমন "America/New_York"।
version	string ঐচ্ছিক। IANA টাইম জোন ডেটাবেস সংস্করণ নম্বর, যেমন "2019a"।