DateTime

• JSON উপস্থাপনা

সিভিল টাইম (অথবা মাঝে মাঝে ভৌত সময়) প্রতিনিধিত্ব করে।

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

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

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

যদি বছর, মাস, অথবা দিন ০ হয়, তাহলে DateTime-এর যথাক্রমে কোন নির্দিষ্ট বছর, মাস, অথবা দিন নেই বলে বিবেচিত হবে।

এই ধরণটি একটি ভৌত ​​সময় প্রতিনিধিত্ব করার জন্যও ব্যবহার করা যেতে পারে যদি সমস্ত তারিখ এবং সময় ক্ষেত্র সেট করা থাকে এবং 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 ঐচ্ছিক। তারিখের বছর। ১ থেকে ৯৯৯৯ পর্যন্ত হতে হবে, অথবা যদি বছর ছাড়া তারিখের সময় উল্লেখ করা হয় তবে ০ হতে হবে।
month	integer ঐচ্ছিক। বছরের মাস। ১ থেকে ১২ পর্যন্ত হতে হবে, অথবা মাস ছাড়া তারিখ-সময় উল্লেখ করলে ০ হতে হবে।
day	integer ঐচ্ছিক। মাসের দিন। ১ থেকে ৩১ তারিখ পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা যদি দিন ছাড়া তারিখ-সময় উল্লেখ করা হয় তবে ০ হতে হবে।
hours	integer ঐচ্ছিক। দিনের সময় ২৪ ঘন্টার ফর্ম্যাটে। ০ থেকে ২৩ এর মধ্যে হওয়া উচিত, ডিফল্ট ০ (মধ্যরাত)। ব্যবসা বন্ধের সময় এর মতো পরিস্থিতিতে একটি API "২৪:০০:০০" মানটি মঞ্জুর করতে পারে।
minutes	integer ঐচ্ছিক। দিনের ঘন্টার মিনিট। ০ থেকে ৫৯ এর মধ্যে হতে হবে, ডিফল্ট ০।
seconds	integer ঐচ্ছিক। সময়ের মিনিটের সেকেন্ড। সাধারণত ০ থেকে ৫৯ এর মধ্যে হতে হবে, ডিফল্ট ০। একটি API যদি লিপ-সেকেন্ডের অনুমতি দেয় তবে মান ৬০ মঞ্জুর করতে পারে।
nanos	integer ঐচ্ছিক। ন্যানোসেকেন্ডে সেকেন্ডের ভগ্নাংশ। ০ থেকে ৯৯৯,৯৯৯,৯৯৯ হতে হবে, ডিফল্ট ০।
Union ফিল্ড time_offset । ঐচ্ছিক। UTC অফসেট অথবা DateTime এর সময় অঞ্চল নির্দিষ্ট করে। ভবিষ্যতে সময় অঞ্চলের ডেটা পরিবর্তন হতে পারে তা বিবেচনা করে সাবধানতার সাথে তাদের মধ্যে নির্বাচন করুন (উদাহরণস্বরূপ, একটি দেশ তাদের DST শুরু/শেষ তারিখ পরিবর্তন করে, এবং প্রভাবিত পরিসরে ভবিষ্যতের DateTimes ইতিমধ্যেই সংরক্ষণ করা হয়েছে)। যদি বাদ দেওয়া হয়, তাহলে DateTime স্থানীয় সময়ে বিবেচিত হবে। time_offset নিম্নলিখিতগুলির মধ্যে শুধুমাত্র একটি হতে পারে:
utcOffset	string ( Duration format) UTC অফসেট। -১৮ ঘন্টা থেকে +১৮ ঘন্টার মধ্যে পুরো সেকেন্ড হতে হবে। উদাহরণস্বরূপ, -৪:০০ এর একটি UTC অফসেট { সেকেন্ড: -১৪৪০০ } হিসাবে উপস্থাপন করা হবে। সেকেন্ডে একটি সময়কাল যার সর্বোচ্চ নয়টি ভগ্নাংশ সংখ্যা ' s ' দিয়ে শেষ হয়। উদাহরণ: "3.5s" ।
timeZone	object ( TimeZone ) সময় অঞ্চল।