محور التاريخ

سيناريوهات الاستخدام المحتملة

عند إنشاء رسم بياني من بيانات ورقة العمل التي تستخدم تواريخ، ويتم رسم التواريخ على طول المحور الأفقي (الفئة) في الرسم البياني، يقوم Aspose.cells تلقائيًا بتغيير المحور الفئة إلى محور تاريخ (مقياس زمني). يعرض محور التاريخ التواريخ وفقًا للترتيب الزمني بفواصل زمنية محددة أو وحدات قاعدية، مثل عدد الأيام، أو الأشهر، أو السنوات، حتى إذا كانت التواريخ على ورقة العمل ليست بترتيب تسلسلي أو بنفس الوحدات القاعدية. بشكل افتراضي، يحدد Aspose.cells وحدات الأساس لمحور التاريخ بناءً على أصغر فرق بين أي تاريخين في بيانات ورقة العمل. على سبيل المثال، إذا كانت لديك بيانات لأسعار الأسهم حيث أصغر فرق بين التواريخ هو سبعة أيام، فإن Excel يضبط الوحدة الأساسية على الأيام، ولكن يمكنك تغيير الوحدة الأساسية إلى أشهر أو سنوات إذا كنت ترغب في رؤية أداء السهم على مدى فترة زمنية أطول.

معاملة محور التاريخ مثل Microsoft Excel

يرجى الاطلاع على الكود النموذجي التالي الذي ينشئ ملف إكسل جديد ويضع قيم الرسم البياني في الورقة العمل الأولى. ثم نضيف رسم بياني ونعين نوع الـ Axis  إلى TimeScale ومن ثم نضبط الوحدات الأساسية على الأيام.

todo:image_alt_text

الكود المثال التالي يولد ملف 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");
view raw DateAxis.java hosted with ❤ by GitHub