محور التاريخ
سيناريوهات الاستخدام المحتملة
عند إنشاء رسم بياني من بيانات ورقة العمل التي تستخدم تواريخ، ويتم رسم التواريخ على طول المحور الأفقي (الفئة) في الرسم البياني، يقوم Aspose.cells تلقائيًا بتغيير المحور الفئة إلى محور تاريخ (مقياس زمني). يعرض محور التاريخ التواريخ وفقًا للترتيب الزمني بفواصل زمنية محددة أو وحدات قاعدية، مثل عدد الأيام، أو الأشهر، أو السنوات، حتى إذا كانت التواريخ على ورقة العمل ليست بترتيب تسلسلي أو بنفس الوحدات القاعدية. بشكل افتراضي، يحدد Aspose.cells وحدات الأساس لمحور التاريخ بناءً على أصغر فرق بين أي تاريخين في بيانات ورقة العمل. على سبيل المثال، إذا كانت لديك بيانات لأسعار الأسهم حيث أصغر فرق بين التواريخ هو سبعة أيام، فإن Excel يضبط الوحدة الأساسية على الأيام، ولكن يمكنك تغيير الوحدة الأساسية إلى أشهر أو سنوات إذا كنت ترغب في رؤية أداء السهم على مدى فترة زمنية أطول.
معاملة محور التاريخ مثل Microsoft Excel
يرجى الاطلاع على الكود النموذجي التالي الذي ينشئ ملف إكسل جديد ويضع قيم الرسم البياني في الورقة العمل الأولى. ثم نضيف رسم بياني ونعين نوع الـ Axis إلى TimeScale ومن ثم نضبط الوحدات الأساسية على الأيام.
الكود المثال التالي يولد ملف Excel الناتج.
الكود المثالي
// Create an instance of Workbook | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet | |
Worksheet worksheet = workbook.getWorksheets().get(0); | |
// Add the sample values to cells | |
worksheet.getCells().get("A1").putValue("Date"); | |
// 14 means datetime format | |
Style style = worksheet.getCells().getStyle(); | |
style.setNumber(14); | |
// Put values to cells for creating chart | |
worksheet.getCells().get("A2").setStyle(style); | |
worksheet.getCells().get("A2").putValue(new DateTime(2022, 6, 26)); | |
worksheet.getCells().get("A3").setStyle(style); | |
worksheet.getCells().get("A3").putValue(new DateTime(2022, 5, 22)); | |
worksheet.getCells().get("A4").setStyle(style); | |
worksheet.getCells().get("A4").putValue(new DateTime(2022, 8, 3)); | |
worksheet.getCells().get("B1").putValue("Price"); | |
worksheet.getCells().get("B2").putValue(40); | |
worksheet.getCells().get("B3").putValue(50); | |
worksheet.getCells().get("B4").putValue(60); | |
// Adda chart to the worksheet | |
int chartIndex = worksheet.getCharts().add(ChartType.COLUMN, 9, 6, 21, 13); | |
// Access the instance of the newly added chart | |
Chart chart = worksheet.getCharts().get(chartIndex); | |
// Add SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B4" | |
chart.setChartDataRange("A1:B4", true); | |
// Set the Axis type to Date time | |
chart.getCategoryAxis().setCategoryType(CategoryType.TIME_SCALE); | |
// Set the base unit for CategoryAxis to days | |
chart.getCategoryAxis().setBaseUnitScale(TimeUnit.DAYS); | |
// Set the direction for the axis text to be vertical | |
chart.getCategoryAxis().getTickLabels().setDirectionType(ChartTextDirectionType.VERTICAL); | |
// Fill the PlotArea area with nothing | |
chart.getPlotArea().getArea().getFillFormat().setFillType(FillType.NONE); | |
// Set max value of Y axis. | |
chart.getValueAxis().setMaxValue(70); | |
// Set major unit. | |
chart.getValueAxis().setMajorUnit(10); | |
// Save the file | |
workbook.save("DateAxis.xlsx"); | |