সূচক
তারিখ সময়
নাগরিক সময় (বা মাঝে মাঝে শারীরিক সময়) প্রতিনিধিত্ব করে।
এই প্রকারটি কয়েকটি সম্ভাব্য উপায়ের একটিতে একটি নাগরিক সময়কে উপস্থাপন করতে পারে:
- যখন 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 | সময় অঞ্চল. |
LatLng
একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই WGS84 মান মেনে চলতে হবে। মানগুলি অবশ্যই স্বাভাবিক সীমার মধ্যে থাকতে হবে৷
| ক্ষেত্র | |
|---|---|
latitude | ডিগ্রী অক্ষাংশ. এটি অবশ্যই [-90.0, +90.0] এর মধ্যে হতে হবে। |
longitude | ডিগ্রী দ্রাঘিমাংশ. এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে। |
সময় অঞ্চল
IANA টাইম জোন ডেটাবেস থেকে একটি সময় অঞ্চল প্রতিনিধিত্ব করে৷
| ক্ষেত্র | |
|---|---|
id | IANA টাইম জোন ডাটাবেস টাইম জোন, যেমন "America/New_York"। |
version | ঐচ্ছিক। IANA টাইম জোন ডেটাবেস সংস্করণ নম্বর, যেমন "2019a"। |